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.