PR_TransmitFile

Sends a complete file across a connected socket.

Syntax

#include <prio.h> 

PRInt32 PR_TransmitFile(
  PRFileDesc *networkSocket, 
  PRFileDesc *sourceFile,
  const void *headers, 
  PRInt32 hlen, 
  PRTransmitFileFlags flags,
  PRIntervalTime timeout);

Parameters

The function has the following parameters:

networkSocket
A pointer to a PRFileDesc object representing the connected socket to send data over.
sourceFile
A pointer to a PRFileDesc object representing the file to send.
headers
A pointer to the buffer holding the headers to be sent before sending data.
hlen
Length of the headers buffer in bytes.
flags
One of the following flags:
timeout
Time limit for completion of the transmit operation.

Returns

Description

The PR_TransmitFile function sends a complete file (sourceFile) across a connected socket (networkSocket). If headers is non-NULL, PR_TransmitFile sends the headers across the socket before sending the file.

The enumeration PRTransmitFileFlags, used in the flags parameter, is defined as follows:

typedef enum PRTransmitFileFlags {
  PR_TRANSMITFILE_KEEP_OPEN = 0,
  PR_TRANSMITFILE_CLOSE_SOCKET = 1
} PRTransmitFileFlags;