IComSecurityEvents::OnAuthenticate method (comsvcs.h)

Generated when a method call level authentication succeeds. When you set an authentication level for an application, you determine what degree of authentication is performed when clients call into the application.

Syntax

HRESULT OnAuthenticate(
  [in] COMSVCSEVENTINFO *pInfo,
  [in] REFGUID          guidActivity,
  [in] ULONG64          ObjectID,
  [in] REFGUID          guidIID,
  [in] ULONG            iMeth,
  [in] ULONG            cbByteOrig,
  [in] BYTE             *pSidOriginalUser,
  [in] ULONG            cbByteCur,
  [in] BYTE             *pSidCurrentUser,
  [in] BOOL             bCurrentUserInpersonatingInProc
);

Parameters

[in] pInfo

A pointer to a COMSVCSEVENTINFO structure.

[in] guidActivity

The identifier of the activity in which the object is created.

[in] ObjectID

The just-in-time activated object.

[in] guidIID

The IID of the method.

[in] iMeth

The v-table index of the method.

[in] cbByteOrig

The number of bytes in the security identifier for the original caller.

[in] pSidOriginalUser

The security identifier for the original caller.

[in] cbByteCur

The number of bytes in the security identifier for the current caller.

[in] pSidCurrentUser

The security identifier for the current caller.

[in] bCurrentUserInpersonatingInProc

Indicates whether the current user is impersonating.

Return value

The user verifies the return values from this method.

Requirements

Requirement Value
Minimum supported client Windows 2000 Professional [desktop apps only]
Minimum supported server Windows 2000 Server [desktop apps only]
Target Platform Windows
Header comsvcs.h

See also

IComSecurityEvents