SOLE_AUTHENTICATION_INFO structure (objidlbase.h)

Identifies an authentication service, authorization service, and the authentication information for the specified authentication service.

Syntax

typedef struct tagSOLE_AUTHENTICATION_INFO {
  DWORD dwAuthnSvc;
  DWORD dwAuthzSvc;
  void  *pAuthInfo;
} SOLE_AUTHENTICATION_INFO, *PSOLE_AUTHENTICATION_INFO;

Members

dwAuthnSvc

The authentication service. This member can be a single value from the Authentication Service Constants.

dwAuthzSvc

The authorization service. This member can be a single value from the Authorization Constants.

pAuthInfo

A pointer to the authentication information, whose type is specific to the authentication service identified by dwAuthnSvc.

For Schannel (RPC_C_AUTHN_GSS_SCHANNEL), this member either points to a CERT_CONTEXT structure that contains the client's X.509 certificate or is NULL if the client has no certificate or wishes to remain anonymous to the server.

For NTLMSSP (RPC_C_AUTHN_WINNT) and Kerberos (RPC_C_AUTHN_GSS_KERBEROS), this member points to a SEC_WINNT_AUTH_IDENTITY or SEC_WINNT_AUTH_IDENTITY_EX structure that contains the user name and password.

For Snego (RPC_C_AUTHN_GSS_NEGOTIATE), this member is either NULL, points to a SEC_WINNT_AUTH_IDENTITY structure, or points to a SEC_WINNT_AUTH_IDENTITY_EX structure. If it is NULL, Snego will pick a list of authentication services based on those available on the client computer. If it points to a SEC_WINNT_AUTH_IDENTITY_EX structure, the structure's PackageList member must point to a string containing a comma-separated list of authentication service names and the PackageListLength member must give the number of bytes in the PackageList string. If PackageList is NULL, all calls using Snego will fail.

For authentication services not registered with DCOM, pAuthInfo must be set to NULL and DCOM will use the process identity to represent the client. For more information, see COM and Security Packages.

Requirements

Requirement Value
Minimum supported client Windows 2000 Professional [desktop apps only]
Minimum supported server Windows 2000 Server [desktop apps only]
Header objidlbase.h (include Objidl.h)

See also

CoInitializeSecurity

CoSetProxyBlanket

SOLE_AUTHENTICATION_LIST