IServerClient::EnumAvailableContacts method

---

Retrieves the array of user contacts available to current user on the IM server.

HRESULT EnumAvailableContacts(
    LPDWORD lpTransferOUsArray,
    LPDWORD lpTransferContactsArray,
    LPDWORD lpdwExtendedCode
);

Parameters

lpTransferOUsArray

[out] Pointer to an array of TRANSFER_OU_STRUCT structure that receives Organizational Units.

lpTransferContactsArray

[out] Pointer to an array of TRANSFER_CONTACT_STRUCT structure that receives user contacts.

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.

Remarks

The sizes of the arrays pointed by the lpTransferOUsArray and lpTransferContactsArray members must be equal to the nOUCount and nContactsCount members of TRANSFER_CONTACT_LIST_STRUCT returned by previous call of IServerClient::GetAvailableContacts function.