IServerClient::GetAccountInformation method

Retrieves information on current user account with a set of modification flags from the IM server.

HRESULT GetAccountInformation(     LPDWORD lpdwAccountFlags,     LPSTR lpszAccountFirstName,     LPSTR lpszAccountLastName,     LPDWORD lpdwExtendedCode );

Parameters

lpdwAccountFlags
[out] Array of bitwise flags that indicate permissions of current user and relate to the IM client functionality. These flags are set on the IM server and cannot be changed by users. This member can be one or more of the following values:
ESTABLISH_FLAG_CONFIRMATION_MODE
Requires the IM client to operate in the Confirmation Mode.
ESTABLISH_FLAG_FILE_TRANSFER_DISABLED
Sending files and directories is disabled.
ESTABLISH_FLAG_BRANDING
The IM server delivers image logo and associated URL (branding) on establishing session.
ESTABLISH_FLAG_CANNOT_CHANGE_CONTACTS
Changing user's contacts (Contact List) is disabled.
ESTABLISH_FLAG_CAN_SEND_PRIORITY_MESSAGES
The user has permission to send urgent (priority) instant messages.
ESTABLISH_FLAG_CAN_SEND_CONFIRM_MESSAGES
The user has permission to send instant messages with confirmation response.
ESTABLISH_FLAG_TYPING_EVENT_DISABLED
The IM server disables delivery of message typing event notification.
lpszAccountFirstName
[out] Pointer to a text buffer that receives user's first name. Size of the buffer must be 64 symbols of length.
lpszAccountLastName
[out] Pointer to a text buffer that receives user's last name. Size of the buffer must be 64 symbols of length.
lpdwExtendedCode
[out] Pointer to a DWORD variable that gets an extended code if error result is returned. For available codes see Available Extended Codes topic.

Return Value

S_OK
The function was successful.
E_INVALIDARG
One or more arguments are incorrect.
E_FAIL
Some error occurred in the function. Check lpdwExtendedCode variable to get extended information on the error.