IAzApplication2::InitializeClientContext2 method (azroles.h)

The InitializeClientContext2 method retrieves an IAzClientContext2 object pointer.

Syntax

HRESULT InitializeClientContext2(
  [in]           BSTR              IdentifyingString,
  [in, optional] VARIANT           varReserved,
  [out]          IAzClientContext2 **ppClientContext
);

Parameters

[in] IdentifyingString

A string that identifies the client context in the audit trail for client connection and object access audit entries.

[in, optional] varReserved

Reserved for future use.

[out] ppClientContext

A pointer to a pointer to the returned IAzClientContext2 object.

Return value

If the method succeeds, the method returns S_OK.

If the method fails, it returns an HRESULT value that indicates the error. For a list of common error codes, see Common HRESULT Values.

Requirements

Requirement Value
Minimum supported client Windows Vista [desktop apps only]
Minimum supported server Windows Server 2008, Windows Server 2003 with SP1 [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