Função CoQueryAuthenticationServices (combaseapi.h)
Recupera uma lista dos serviços de autenticação registrados quando o processo chamado CoInitializeSecurity.
Sintaxe
HRESULT CoQueryAuthenticationServices(
[out] DWORD *pcAuthSvc,
[out] SOLE_AUTHENTICATION_SERVICE **asAuthSvc
);
Parâmetros
[out] pcAuthSvc
Um ponteiro para uma variável que recebe o número de entradas retornadas na matriz asAuthSvc .
[out] asAuthSvc
Um ponteiro para uma matriz de estruturas de SOLE_AUTHENTICATION_SERVICE . A lista é alocada por meio de uma chamada para a função CoTaskMemAlloc . O chamador deve liberar a lista quando terminar com ela chamando a função CoTaskMemFree .
Retornar valor
Essa função pode retornar os valores de retorno padrão E_INVALIDARG, E_OUTOFMEMORY e S_OK.
Comentários
CoQueryAuthenticationServices recupera uma lista dos serviços de autenticação registrados no momento. Se o processo chamar CoInitializeSecurity, esses serão os serviços registrados por meio dessa chamada. Se o aplicativo não chamá-lo, CoInitializeSecurity será chamado automaticamente pelo COM, registrando o pacote de segurança padrão, na primeira vez em que uma interface é marshaled ou desmarsada.
Essa função retorna apenas os serviços de autenticação registrados com CoInitializeSecurity. Ele não retorna todos os serviços de autenticação instalados no computador, mas EnumerateSecurityPackages retorna. CoQueryAuthenticationServices é útil principalmente para marshalers personalizados, para determinar quais nomes de entidade de segurança um aplicativo pode usar.
Diferentes serviços de autenticação dão suporte a diferentes níveis de segurança. Por exemplo, o NTLMSSP não dá suporte à delegação nem à autenticação mútua enquanto o Kerberos o faz. O aplicativo é responsável apenas por registrar serviços de autenticação que fornecem os recursos de que o aplicativo precisa. Essa função fornece uma maneira de descobrir quais serviços foram registrados com CoInitializeSecurity.
Requisitos
| Requisito | Valor |
|---|---|
| Cliente mínimo com suporte | Windows 2000 Professional [somente aplicativos da área de trabalho] |
| Servidor mínimo com suporte | Windows 2000 Server [somente aplicativos da área de trabalho] |
| Plataforma de Destino | Windows |
| Cabeçalho | combaseapi.h (inclua Objbase.h) |
| Biblioteca | Ole32.lib |
| DLL | Ole32.dll |