SOLE_AUTHENTICATION_SERVICE

Identifies an authentication service. This structure is retrieved through a call to CoQueryAuthenticationServices, and passed in to CoInitializeSecurity.

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

Members

dwAuthnSvc

The authentication service. It may contain a single value taken from the list of RPC_C_AUTHN_xxx constants defined in rpcdce.h. RPC_C_AUTHN_NONE turns off authentication. On Win32, RPC_C_AUTHN_DEFAULT causes COM to use the RPC_C_AUTHN_WINNT authentication.

dwAuthzSvc

The authorization service. It may contain a single value taken from the list of RPC_C_AUTHZ_xxx constants defined in rpcdce.h. The validity and trustworthiness of authorization data, like any application data, depends on the authentication service and authentication level selected. This parameter is ignored when using the RPC_C_AUTHN_WINNT authentication service.

pPrincipalName

Principal name to be used with the authentication service. If the principal name is NULL, COM assumes the current user identifier. A NULL principal name is allowed for NT LM SSP and kerberos authentication services, but may not work for other authentication services.

hr

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

QuickInfo

  Windows NT: Use version 4.0 or later.
  Windows: Use Windows 95 or later. Available as a redistributable for Windows 95.
  Windows CE: Unsupported.
  Header: Declared in objidl.h.

See Also

RPC_C_AUTHN_xxx, RPC_C_AUTHZ_xxx, CoInitializeSecurity