CoQueryAuthenticationServices
.gif "A checkmark indicates that the information in this topic is relevant for this platform, and that any API listed is also supported on this platform.")
.gif "A checkmark indicates that the information in this topic is relevant for this platform, and that any API listed is also supported on this platform.")
9/8/2008
Essa função recupera uma lista dos serviços de autenticação registrado quando o processo chamado CoInitializeSecurity.
Syntax
HRESULT CoQueryAuthenticationServices(
DWORD* pcAuthSvc,
SOLE_AUTHENTICATION_SERVICE** asAuthSvc
);
Parameters
- pcAuthSvc
[out] Ponteiro para retornar o número de entradas retornadas in a rgAuthSvc matriz. Pode não ser NULL.
- asAuthSvc
[out] Ponteiro para uma matriz de SOLE_AUTHENTICATION_SERVICE estruturas. A lista é alocada por um chamar para CoTaskMemAlloc. O chamador deve livre a lista quando terminar com ele por chamado CoTaskMemFree.
Return Value
O padrão oferece suporte a essa função retornar valores E_INVALIDARG e E_OUTOFMEMORY, bem como o seguinte:
- S_OK
Indica sucesso.
Remarks
CoQueryAuthenticationServices Recupera uma lista dos serviços de autenticação atualmente registrados.
Se o processo chama CoInitializeSecurity, esses são os serviços registrados por meio desse chamar.
Se o aplicativo não chamar, CoInitializeSecurity é chamado automaticamente por registrar o pacote de segurança usar como padrão, o primeiro tempo uma interface é empacotado ou unmarshaled, COM.
Essa função retorna que apenas os serviços autenticação registrados com CoInitializeSecurity. Ela não retorna todos os serviços autenticação instalados a máquina. CoQueryAuthenticationServices é útil principalmente para personalizado empacotadores, para determinar qual principal nomeia um aplicativo podem usar.
Autenticação diferentes serviços Ajuda suporte diferentes níveis de segurança. De exemplo, NTLMSSP não não suporte delegação ou autenticação mútua enquanto Kerberos.
O aplicativo é responsável somente para registrar serviços autenticação que fornecem os recursos de aplicativo precisa. Essa função fornece uma maneira de localizar fora quais serviços foram registradas com CoInitializeSecurity.
Para determinar se a plataforma oferece suporte a essa função, consulte Determinando suporte COM APIs.
Requirements
| Header | objbase.h |
| Library | ole32.lib |
| Windows Embedded CE | Windows CE 3.0 and later |
| Windows Mobile | Windows Mobile Version 5.0 and later |