Función QueryContextAttributesA (sspi.h)
La función QueryContextAttributes (CredSSP) permite a una aplicación de transporte consultar el paquete de seguridad del proveedor de seguridad de credenciales (CredSSP) para determinados atributos de un contexto de seguridad.
Sintaxis
SECURITY_STATUS SEC_ENTRY QueryContextAttributesA(
[in] PCtxtHandle phContext,
[in] unsigned long ulAttribute,
[out] void *pBuffer
);
Parámetros
[in] phContext
Identificador del contexto de seguridad que se va a consultar.
[in] ulAttribute
Atributo del contexto que se va a devolver. Este parámetro puede ser uno de los valores siguientes. A menos que se especifique lo contrario, los atributos son aplicables tanto al cliente como al servidor.
| Valor | Significado |
|---|---|
|
El parámetro pBuffer contiene un puntero a una estructura de SecPkgContext_AccessToken que especifica el token de acceso para el contexto de seguridad actual.
Este atributo solo se admite en el servidor. |
|
El parámetro pBuffer contiene un puntero a una estructura de SecPkgContext_AccessToken que especifica el token de acceso para el contexto de seguridad actual.
Este atributo solo se admite en el servidor. |
|
El parámetro pBuffer contiene un puntero a una estructura de CERT_TRUST_STATUS que especifica información de confianza sobre el certificado.
Este atributo solo se admite en el cliente. |
|
El parámetro pBuffer contiene un puntero a una estructura de SecPkgContext_ClientCreds que especifica las credenciales de cliente.
Las credenciales de cliente pueden ser el nombre de usuario y la contraseña o el nombre de usuario y el PIN de tarjeta inteligente. Este atributo solo se admite en el servidor. |
|
El parámetro pBuffer contiene un puntero a una estructura de SecPkgContext_ClientCreds que especifica las credenciales de cliente.
Si la credencial de cliente es el nombre de usuario y la contraseña, el búfer es una estructura KERB_INTERACTIVE_LOGON empaquetada. Si la credencial de cliente es el nombre de usuario y el PIN de la tarjeta inteligente, el búfer es una estructura de KERB_CERTIFICATE_LOGON empaquetada. Si la credencial de cliente es una credencial de identidad en línea, el búfer es una estructura de SEC_WINNT_AUTH_IDENTITY_EX2 serializado. Este atributo solo se admite en el servidor CredSSP. Windows Server 2008 R2, Windows 7, Windows Server 2008, Windows Vista, Windows Server 2003 y Windows XP: Este valor no se admite. |
|
El parámetro pBuffer contiene un puntero a una estructura SecPkgContext_PackageInfo">SecPkgContext_PackageInfo que especifica el nombre del paquete de autenticación negociado por el proveedor microsoft Negotiate . |
|
El parámetro pBuffer contiene un puntero a una estructura SecPkgContext_PackageInfo">SecPkgContext_PackageInfo .
Devuelve información sobre el SSP en uso. |
|
El parámetro pBuffer contiene un puntero a una estructura de SecPkgContext_Flags que especifica información sobre las marcas en el contexto de seguridad actual.
Este atributo solo se admite en el cliente. |
|
El parámetro pBuffer contiene un puntero a una estructura de SecPkgContext_Sizes .
Consulta los tamaños de las estructuras usadas en las funciones por mensaje y los intercambios de autenticación. |
|
El parámetro pBuffer contiene un puntero a una estructura de SecPkgContext_SubjectAttributes .
Este valor devuelve información sobre los atributos de seguridad de la conexión. Este valor solo se admite en el servidor CredSSP. Windows Server 2008, Windows Vista, Windows Server 2003 y Windows XP: Este valor no se admite. |
[out] pBuffer
Puntero a una estructura que recibe los atributos. El tipo de estructura depende del valor del parámetro ulAttribute .
Valor devuelto
Si la función se realiza correctamente, devuelve SEC_E_OK.
Si se produce un error en la función, puede devolver los siguientes códigos de error.
| Código o valor devuelto | Descripción |
|---|---|
|
Error en la función. El parámetro phContext especifica un identificador para un contexto incompleto. |
|
Error en la función. El valor del parámetro ulAttribute no es válido. |
Comentarios
La estructura a la que apunta el parámetro pBuffer varía en función del atributo que se consulta.
Aunque el autor de la llamada debe asignar la propia estructura pBuffer , el SSP asigna cualquier memoria necesaria para contener miembros de tamaño variable de la estructura pBuffer . La memoria asignada por el SSP debe liberarse llamando a la función FreeContextBuffer .
Nota
El encabezado sspi.h define QueryContextAttributes como alias que selecciona automáticamente la versión ANSI o Unicode de esta función en función de la definición de la constante de preprocesador UNICODE. La combinación del uso del alias neutral de codificación con código que no es neutral de codificación puede dar lugar a errores de coincidencia que dan lugar a errores de compilación o tiempo de ejecución. Para obtener más información, vea Convenciones para prototipos de función.
Requisitos
| Requisito | Value |
|---|---|
| Cliente mínimo compatible | Windows Vista [solo aplicaciones de escritorio] |
| Servidor mínimo compatible | Windows Server 2008 [solo aplicaciones de escritorio] |
| Plataforma de destino | Windows |
| Encabezado | sspi.h (include Security.h) |
| Library | Secur32.lib |
| Archivo DLL | Secur32.dll |