Función CoQueryAuthenticationServices (combaseapi.h)
Recupera una lista de los servicios de autenticación registrados cuando el proceso llamado CoInitializeSecurity.
Sintaxis
HRESULT CoQueryAuthenticationServices(
[out] DWORD *pcAuthSvc,
[out] SOLE_AUTHENTICATION_SERVICE **asAuthSvc
);
Parámetros
[out] pcAuthSvc
Puntero a una variable que recibe el número de entradas devueltas en la matriz asAuthSvc .
[out] asAuthSvc
Puntero a una matriz de estructuras de SOLE_AUTHENTICATION_SERVICE . La lista se asigna a través de una llamada a la función CoTaskMemAlloc . El autor de la llamada debe liberar la lista cuando termine con ella llamando a la función CoTaskMemFree .
Valor devuelto
Esta función puede devolver los valores devueltos estándar E_INVALIDARG, E_OUTOFMEMORY y S_OK.
Comentarios
CoQueryAuthenticationServices recupera una lista de los servicios de autenticación registrados actualmente. Si el proceso llama a CoInitializeSecurity, estos son los servicios registrados a través de esa llamada. Si la aplicación no la llama, COM llama automáticamente a CoInitializeSecurity , registrando el paquete de seguridad predeterminado, la primera vez que se serializa una interfaz o se anula la excepción.
Esta función devuelve solo los servicios de autenticación registrados con CoInitializeSecurity. No devuelve todos los servicios de autenticación instalados en el equipo, pero EnumerateSecurityPackages sí. CoQueryAuthenticationServices es principalmente útil para los serializadores personalizados, para determinar qué nombres principales puede usar una aplicación.
Los distintos servicios de autenticación admiten distintos niveles de seguridad. Por ejemplo, NTLMSSP no admite la delegación ni la autenticación mutua mientras Kerberos lo hace. La aplicación solo es responsable de registrar los servicios de autenticación que proporcionan las características que necesita la aplicación. Esta función proporciona una manera de averiguar qué servicios se han registrado con CoInitializeSecurity.
Requisitos
| Requisito | Value |
|---|---|
| Cliente mínimo compatible | Windows 2000 Professional [solo aplicaciones de escritorio] |
| Servidor mínimo compatible | Windows 2000 Server [solo aplicaciones de escritorio] |
| Plataforma de destino | Windows |
| Encabezado | combaseapi.h (incluya Objbase.h) |
| Library | Ole32.lib |
| Archivo DLL | Ole32.dll |