Edit

Share via

IAzApplication::InitializeClientContextFromToken method (azroles.h)

  • Article

The InitializeClientContextFromToken method gets an IAzClientContext object pointer from the specified client token.

Syntax

HRESULT InitializeClientContextFromToken(
  [in]           ULONGLONG        ullTokenHandle,
  [in, optional] VARIANT          varReserved,
  [out]          IAzClientContext **ppClientContext
);

Parameters

[in] ullTokenHandle

A handle to a Windows token that specifies the client. If this parameter is NULL, the impersonation token of the caller's thread is used. If the thread does not have an impersonation token, the process token is used. The token must have been opened for TOKEN_QUERY, TOKEN_IMPERSONATE, and TOKEN_DUPLICATE access.

[in, optional] varReserved

Reserved for future use.

[out] ppClientContext

A pointer to a pointer to the returned IAzClientContext object.

Return value

If the method succeeds, the method returns S_OK.

Any other HRESULT value indicates that the operation failed.

Requirements

Requirement Value
Minimum supported client Windows Vista [desktop apps only]
Minimum supported server Windows Server 2003 [desktop apps only]
Target Platform Windows
Header azroles.h
Library Azroles.lib
DLL Azroles.dll
Redistributable Windows Server 2003 Administration Tools Pack on Windows XP