IServerClient::GetSessionKey method

---

Retrieves the GUID string of current established session with the IM server.

HRESULT GetSessionKey(
    LPSTR lpszSessionKey,
    LPDWORD lpdwExtendedCode
);

Parameters

lpszSessionKey

[out] Pointer to a character buffer that receives the GUID of current established session with the IM server. Size of the buffer must be SESSION_KEY_LENGTH 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.