TRANSFER_FILE_STRUCT structure

---

Specifies information on outgoing file transfer.

typedef struct _TRANSFER_FILE_STRUCT
{
    DWORD dwTransferFlags;
    FILE_INFO_STRUCT lpFileInfo;
    INT nRecipientsCount;
} TRANSFER_FILE_STRUCT;

Members

dwTransferFlags

Array of bitwise flags that specify parameters of the file transfer. This member can be one or more of the following values:

FILE_TRANSFER_FLAG_OFFLINE

Indicates allowance to save outgoing files/directories as offline data on the IM server if all or some recipients are unavailable.

FILE_TRANSFER_FLAG_OPEN_FOLDER

Forces the recipient's IM client to open a receiving folder when the file transmission will be completed. This flag is available for set only when lpdwAccountFlags returned by IServerClient::GetAccountInformation method has ESTABLISH_FLAG_CAN_SEND_PRIORITY_MESSAGES flag set.

FILE_TRANSFER_FLAG_OPEN_FILE

Forces the recipient's IM client to open/execute the file when the transmission will be completed. This flag is available for set only when lpdwAccountFlags returned by IServerClient::GetAccountInformation method has ESTABLISH_FLAG_CAN_SEND_PRIORITY_MESSAGES flag set and available for set only if a single file is transferred.

FILE_TRANSFER_FLAG_AUTOMATED

Forces the recipient's IM client to automatically receive delivered data with no options to accept or decline the file transfer. This flag is available for set only when lpdwAccountFlags returned by IServerClient::GetAccountInformation method has ESTABLISH_FLAG_CAN_SEND_PRIORITY_MESSAGES flag set.

lpFileInfo

A FILE_INFO_STRUCT structure that contains information on files/directories that are being sent.

nRecipientsCount

Contains the number of recipients that can include user accounts and messaging groups.