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

La función SpQueryContextAttributes recupera los atributos de un contexto de seguridad.

La función SpQueryContextAttributes es la función de distribución de la función QueryContextAttributes (General) de la interfaz del proveedor de compatibilidad de seguridad.

Sintaxis

SpQueryContextAttributesFn Spquerycontextattributesfn;

NTSTATUS Spquerycontextattributesfn(
  [in]  LSA_SEC_HANDLE ContextHandle,
  [in]  ULONG ContextAttribute,
  [out] PVOID Buffer
)
{...}

Parámetros

[in] ContextHandle

Identificador del contexto de seguridad.

[in] ContextAttribute

Atributo de contexto que se va a consultar. Para obtener una lista de valores válidos, vea la función QueryContextAttributes (General).

[out] Buffer

Puntero que recibe la dirección de un búfer que contiene los atributos solicitados. La memoria del parámetro Buffer debe asignarse con la función AllocateHeap de la tabla de funciones SECPKG_DLL_FUNCTIONS en modo de usuario. En el modo LSA ( Autoridad de seguridad local ), use la función AllocateLsaHeap .

Valor devuelto

Si la función se realiza 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 muestra un motivo común de error y el código de error que debe devolver la función.

Código devuelto	Descripción
SEC_E_INVALID_HANDLE	El identificador no es válido.

Comentarios

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

Hay disponible un puntero a la implementación en modo LSA de la función SpQueryContextAttributes en la estructura SECPKG_FUNCTION_TABLE recibida de la función SpLsaModeInitialize .

Hay disponible un puntero a la implementación en modo de usuario de la función SpQueryContextAttributes en la estructura SECPKG_USER_FUNCTION_TABLE recibida de la función SpUserModeInitialize .

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