SOLE_AUTHENTICATION_SERVICE  2ZFR8H5

Identifies an authentication service. This structure is retrieved through a call to CoQueryAuthenticationServicesKP.R4N, and passed in to CoInitializeSecurity12NDMS.

    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_xxx7Z5JSI 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_xxx29VYICN 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 CoInitializeSecurity12NDMS, set on return to indicate the status of the call to register the authentication services.

See Also