Función QueryContextAttributesExA (sspi.h)
Permite que una aplicación de transporte consulte una de paquete de seguridad de
Sintaxis
SECURITY_STATUS SEC_ENTRY QueryContextAttributesExA(
[in] PCtxtHandle phContext,
[in] unsigned long ulAttribute,
[out] void *pBuffer,
[in] unsigned long cbBuffer
);
Parámetros
[in] phContext
Identificador del contexto de seguridad que se va a consultar.
[in] ulAttribute
Especifica el atributo del contexto que se va a devolver. Este parámetro puede ser uno de los siguientes valores.
| Valor | Significado |
|---|---|
|
El parámetro pBuffer contiene un puntero a una estructura SecPkgContext_AccessToken.
Devuelve un identificador al token de acceso. |
|
El parámetro Devuelve o especifica los datos de la aplicación para la sesión. Este atributo solo es compatible con el paquete de seguridad de Schannel. |
|
El parámetro pBuffer contiene un puntero a una estructura de SecPkgContext_Authority.
Consulta el nombre de la entidad de autenticación. |
|
El parámetro pBuffer contiene un puntero a una estructura de SecPkgContext_ClientSpecifiedTarget que representa el nombre de entidad de seguridad de servicio (SPN) del destino inicial proporcionado por el cliente.
Windows Server 2008, Windows Vista, Windows Server 2003 y Windows XP: Este valor no se admite. |
|
El parámetro Devuelve información detallada sobre la conexión establecida. Este atributo solo es compatible con el paquete de seguridad de Schannel. |
|
El parámetro Si la credencial de cliente es el nombre de usuario y la contraseña, el búfer es una estructura de KERB_INTERACTIVE_LOGON empaquetada. Si la credencial de cliente es el nombre de usuario y el PIN de 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 Consultas de datos de autorización usados por los servicios DCE. |
|
El parámetro pBuffer contiene un puntero a una estructura de SecPkgContext_Bindings que especifica la información de enlace del canal.
Este atributo solo es compatible con el paquete de seguridad de Schannel. 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 de SecPkgContext_EapKeyBlock.
Consultas de datos clave utilizados por el protocolo TLS de EAP. Este atributo solo es compatible con el paquete de seguridad de Schannel. |
|
El parámetro pBuffer contiene un puntero a una estructura SecPkgContext_Flags.
Devuelve información sobre las marcas de contexto negociadas. |
|
El parámetro pBuffer contiene un puntero a una estructura SecPkgContext_IssuerListInfoEx.
Devuelve una lista de emisores de certificados aceptados por el servidor. Este atributo solo es compatible con el paquete de seguridad de Schannel. |
|
El parámetro Consulta información sobre las claves usadas en un contexto de seguridad. |
|
El parámetro Este valor solo es compatible con los paquetes de seguridad Negotiate, Kerberos y NTLM. Windows Server 2008, Windows Vista, Windows Server 2003 y Windows XP: Este valor no se admite. |
|
El parámetro Consulta el período de vida del contexto. |
|
El parámetro pBuffer contiene un puntero a una estructura PCCERT_CONTEXT.
Busca un contexto de certificado que contiene un certificado final local. Este atributo solo es compatible con el paquete de seguridad de Schannel. |
|
El parámetro Reemplazado por SECPKG_ATTR_LOCAL_CERT_CONTEXT. |
|
El parámetro Consulta el nombre asociado al contexto. |
|
El parámetro pBuffer contiene un puntero a una estructura SecPkgContext_NativeNames.
Devuelve el nombre principal (CNAME) del vale de salida. |
|
El parámetro Devuelve información sobre el paquete de seguridad que se va a usar con el proceso de negociación y el estado actual de la negociación para el uso de ese paquete. |
|
El parámetro Devuelve información sobre el SSP en uso. |
|
El parámetro Devuelve información de expiración de contraseña. |
|
El parámetro pBuffer contiene un puntero a una estructura PCCERT_CONTEXT.
Busca un contexto de certificado que contiene el certificado final proporcionado por el servidor. Este atributo solo es compatible con el paquete de seguridad de Schannel. |
|
El parámetro de |
|
El parámetro Devuelve información sobre las claves de sesión. |
|
El parámetro pBuffer contiene un puntero a una estructura de SecPkgContext_SessionInfo.
Devuelve información sobre la sesión. Windows Server 2008, Windows Vista, Windows Server 2003 y Windows XP: Este valor no se admite. Este atributo solo es compatible con el paquete de seguridad de Schannel. |
|
El parámetro pBuffer contiene un puntero a una estructura SecPkgContext_Sizes.
Consulta los tamaños de las estructuras usadas en las funciones por mensaje. |
|
El parámetro pBuffer contiene un puntero a una estructura SecPkgContext_StreamSizes.
Consulta los tamaños de las distintas partes de una secuencia usadas en las funciones por mensaje. Este atributo solo es compatible con el paquete de seguridad de Schannel. |
|
El parámetro 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. |
|
El parámetro pBuffer contiene un puntero a una estructura SecPkgContext_SupportedSignatures.
Este valor devuelve información sobre los tipos de firma que se admiten para la conexión. Este valor solo es compatible con el paquete de seguridad de Schannel. Windows Server 2008, Windows Vista, Windows Server 2003 y Windows XP: Este valor no se admite. |
|
El parámetro Devuelve información sobre el nombre del servidor remoto. |
|
El parámetro pBuffer contiene un puntero a una estructura de SecPkgContext_Bindings que especifica la información de enlace del canal.
Este valor solo es compatible con el paquete de seguridad de Schannel. 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 al que apunta depende del valor especificado en el parámetro ulAttribute .
[in] cbBuffer
Tamaño, en bytes, del parámetro
Valor devuelto
Si la función se ejecuta correctamente, el valor devuelto es SEC_E_OK.
Si se produce un error en la función, el valor devuelto es un código de error distinto de cero.
Observaciones
Nota
El encabezado sspi.h define QueryContextAttributesEx 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 Conventions for Function Prototypes.
Requisitos
| Requisito | Valor |
|---|---|
| cliente mínimo admitido | Windows XP [solo aplicaciones de escritorio] |
| servidor mínimo admitido | Windows Server 2003 [solo aplicaciones de escritorio] |
| de la plataforma de destino de |
Windows |
| encabezado de |
sspi.h (include Security.h) |
| biblioteca de |
Secur32.lib |
| DLL de |
Secur32.dll |
Consulte también
funciones SSPI de