SOLE_AUTHENTICATION_SERVICE (Windows Embedded CE 6.0)

1/6/2010

This structure identifies an authentication service that a server is willing to use to communicate to a client.

This structure is passed by servers to CoInitializeSecurity as a member of the asAuthSvc parameter and can be retrieved through a call to CoQueryAuthenticationServices.

Syntax

typedef struct tagSOLE_AUTHENTICATION_SERVICE {
  DWORD dwAuthnSvc; 
  DWORD dwAuthzSvc; 
  OLECHAR* pPrincipalName; 
  HRESULT hr; 
} SOLE_AUTHENTICATION_SERVICE;

Members

• dwAuthnSvc
  The authentication service.

  It can contain a single value taken from the list of RPC_C_AUTHN_XXX constants. RPC_C_AUTHN_NONE turns off authentication.

• dwAuthzSvc
  The authorization service.

  It can contain a single value taken from the list of RPC_C_AUTHZ_XXX constants.

  This parameter is ignored when using the NTLMSSP (RPC_C_AUTHN_WINNT) authentication service and should be none when using SChannel (RPC_C_AUTHN_GSS_SCHANNEL), Kerberos (RPC_C_AUTHN_GSS_KERBEROS), or Snego (RPC_C_AUTHN_GSS_NEGOTIATE).

• pPrincipalName
  Principal name to be used with the authentication service.

  If the principal name is NULL, the current user identifier is assumed. A NULL principal name is allowed for NTLMSSP, Kerberos, and Snego authentication services but may not work for other authentication services.

  For SChannel, this member must point to a CERT_CONTEXT that contains the server's certificate. It cannot be NULL.

• hr
  When used in CoInitializeSecurity, set on return to indicate the status of the call to register the authentication services.

Requirements

Header	objidl.h
Windows Embedded CE	Windows CE 2.0 and later

See Also

Reference

Storage Structures
CoInitializeSecurity
CoQueryAuthenticationServices