Función QueryContextAttributes (CredSSP)
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 QueryContextAttributes(
_In_ PCtxtHandle phContext,
_In_ ULONG ulAttribute,
_Out_ PVOID pBuffer
);
Parámetros
-
phContext [in]
-
Identificador del contexto de seguridad que se va a consultar.
-
ulAttribute [in]
-
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 - SECPKG_ATTR_C_ACCESS_TOKEN
- 0x80000012
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.- SECPKG_ATTR_C_FULL_ACCESS_TOKEN
- 0x80000082
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.- SECPKG_ATTR_CERT_TRUST_STATUS
- 0x80000084
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.- SECPKG_ATTR_CREDS
- 0x80000080
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 nombre de usuario y contraseña o nombre de usuario y PIN de tarjeta inteligente.
Este atributo solo se admite en el servidor.- SECPKG_ATTR_CREDS_2
- 0x80000086
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 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.- SECPKG_ATTR_NEGOTIATION_PACKAGE
- 0x80000081
El parámetro pBuffer contiene un puntero a una estructura de SecPkgContext_PackageInfo que especifica el nombre del paquete de autenticación negociado por el proveedor de Microsoft Negotiate . - SECPKG_ATTR_PACKAGE_INFO
- 10
El parámetro pBuffer contiene un puntero a una estructura de SecPkgContext_PackageInfo.
Devuelve información sobre el SSP en uso.- SECPKG_ATTR_SERVER_AUTH_FLAGS
- 0x80000083
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.- SECPKG_ATTR_SIZES
- 0x0
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.- SECPKG_ATTR_SUBJECT_SECURITY_ATTRIBUTES
- 124
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. -
pBuffer [out]
-
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 ejecuta 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 .
Requisitos
| Requisito | Value |
|---|---|
| Cliente mínimo compatible |
Windows Vista [solo aplicaciones de escritorio] |
| Servidor mínimo compatible |
Windows Server 2008 [solo aplicaciones de escritorio] |
| Encabezado |
|
| Biblioteca |
|
| Archivo DLL |
|
| Nombres Unicode y ANSI |
QueryContextAttributesW (Unicode) y QueryContextAttributesA (ANSI) |
Consulte también