Función de devolución de llamada SpQueryCredentialsAttributesFn (ntsecpkg.h)

  • Artículo

La función SpQueryCredentialsAttributes recupera los atributos de una credencial.

La función SpQueryCredentialsAttributes es la función dispatch de la función QueryCredentialsAttributes de la interfaz del proveedor de compatibilidad de seguridad.

Sintaxis

SpQueryCredentialsAttributesFn Spquerycredentialsattributesfn;

NTSTATUS Spquerycredentialsattributesfn(
  [in]  LSA_SEC_HANDLE CredentialHandle,
  [in]  ULONG CredentialAttribute,
  [out] PVOID Buffer
)
{...}

Parámetros

[in] CredentialHandle

Identificador de la credencial que se va a consultar.

[in] CredentialAttribute

Atributo que se va a consultar. En la tabla siguiente, se enumeran los valores válidos.

Valor Significado
SECPKG_CRED_ATTR_NAMES
 Nombre de la entidad de seguridad asociada a las credenciales.
SECPKG_ATTR_SUPPORTED_ALGS
 Algoritmos admitidos con una credencial determinada.
SECPKG_ATTR_CIPHER_STRENGTHS
 La intensidad de cifrado mínima y máxima usada con una credencial.
SECPKG_ATTR_SUPPORTED_PROTOCOLS
 Protocolos admitidos con una credencial determinada.

[out] Buffer

Puntero a un búfer que recibe los atributos solicitados. Asigne memoria para este búfer mediante la función AllocateClientBuffer para que el autor de la llamada pueda liberarla llamando a la función FreeContextBuffer .

Valor devuelto

Si la función se ejecuta correctamente, devuelva STATUS_SUCCESS.

Si se produce un error en la función, devuelva un código NTSTATUS que indique el motivo por el que se produjo un error. A continuación se enumeran los motivos comunes de error y los códigos de error que debe devolver la función.

Código devuelto Descripción
SEC_E_INSUFFICIENT_MEMORY
 Se produjo un error de asignación de memoria.
SEC_E_INVALID_HANDLE
 El identificador de credenciales no es válido.

Comentarios

Los SSP/AP deben implementar la función SpQueryCredentialsAttributes ; sin embargo, el nombre real proporcionado a la implementación es para el desarrollador.

Hay disponible un puntero a la función SpQueryCredentialsAttributes en la estructura SECPKG_FUNCTION_TABLE recibida de la función SpLsaModeInitialize .

Requisitos

Requisito Value
Cliente mínimo compatible Windows XP [solo aplicaciones de escritorio]
Servidor mínimo compatible Windows Server 2003 [solo aplicaciones de escritorio]
Plataforma de destino Windows
Encabezado ntsecpkg.h

Consulte también

SECPKG_FUNCTION_TABLE

SpLsaModeInitialize