Función CoQueryClientBlanket (combaseapi.h)
Llamado por el servidor para averiguar el cliente que invocó el método que se ejecuta en el subproceso actual. Se trata de una función auxiliar para IServerSecurity::QueryBlanket.
Sintaxis
HRESULT CoQueryClientBlanket(
[out, optional] DWORD *pAuthnSvc,
[out, optional] DWORD *pAuthzSvc,
[out, optional] LPOLESTR *pServerPrincName,
[out, optional] DWORD *pAuthnLevel,
[out, optional] DWORD *pImpLevel,
[out, optional] RPC_AUTHZ_HANDLE *pPrivs,
[in, out, optional] DWORD *pCapabilities
);
Parámetros
[out, optional] pAuthnSvc
Puntero a una variable que recibe el servicio de autenticación actual. Este será un valor único tomado de las constantes del servicio de autenticación. Si el autor de la llamada especifica NULL, no se recupera el servicio de autenticación actual.
[out, optional] pAuthzSvc
Puntero a una variable que recibe el servicio de autorización actual. Este será un valor único tomado de las constantes de autorización. Si el autor de la llamada especifica NULL, no se recupera el servicio de autorización actual.
[out, optional] pServerPrincName
Nombre principal actual. El autor de la llamada asignará la cadena mediante CoTaskMemAlloc y el autor de la llamada debe liberarla mediante CoTaskMemFree. De forma predeterminada, los nombres principales de Schannel estarán en el formato msstd. Se devolverá el formulario completo si EOAC_MAKE_FULLSIC se especifica en el parámetro pCapabilities . Para obtener más información sobre los formularios msstd y fullsic, vea Nombres principales. Si el autor de la llamada especifica NULL, no se recupera el nombre principal actual.
[out, optional] pAuthnLevel
Puntero a una variable que recibe el nivel de autenticación actual. Este será un valor único tomado de las constantes de nivel de autenticación. Si el autor de la llamada especifica NULL, no se recupera el nivel de autenticación actual.
[out, optional] pImpLevel
Este parámetro debe ser NULL.
[out, optional] pPrivs
Puntero a un identificador que recibe la información de privilegios de la aplicación cliente. El formato de la estructura a la que hace referencia el identificador depende del servicio de autenticación. La aplicación no debe escribir ni liberar la memoria. La información solo es válida durante la llamada actual. Para NTLMSSP y Kerberos, se trata de una cadena que identifica la entidad de seguridad de cliente. Para Schannel, se trata de una estructura de CERT_CONTEXT que representa el certificado del cliente. Si el cliente no tiene ningún certificado, se devuelve NULL . Si el autor de la llamada especifica NULL, no se recupera la información de privilegios actual. Consulte RPC_AUTHZ_HANDLE.
[in, out, optional] pCapabilities
Puntero que devuelve marcas que indican las funcionalidades de la llamada. Para solicitar que el nombre de entidad de seguridad se devuelva en formato completo si Schannel es el servicio de autenticación, el autor de la llamada puede establecer la marca EOAC_MAKE_FULLSIC en este parámetro. Si el autor de la llamada especifica NULL, no se recuperan las funcionalidades actuales.
Valor devuelto
Esta función puede devolver los valores devueltos estándar E_INVALIDARG, E_OUTOFMEMORY y S_OK.
Comentarios
El servidor llama a CoQueryClientBlanket para obtener información de seguridad sobre el cliente que invocó el método que se ejecuta en el subproceso actual. Esta función encapsula la siguiente secuencia de llamadas comunes (se excluye el control de errores):
CoGetCallContext(IID_IServerSecurity, (void**)&pss);
pss->QueryBlanket(pAuthnSvc, pAuthzSvc, pServerPrincName,
pAuthnLevel, pImpLevel, pPrivs, pCapabilities);
pss->Release();
Esta secuencia llama a CoGetCallContext para obtener un puntero a IServerSecurity y, con el puntero resultante, llama a IServerSecurity::QueryBlanket y, a continuación, libera el puntero.
Requisitos
| 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 |