LSA_AP_CALL_PACKAGE función de devolución de llamada (ntsecpkg.h)

Llamado por la entidad de seguridad local (LSA) cuando una aplicación de inicio de sesión con una conexión de confianza a la LSA llama a la función LsaCallAuthenticationPackage y especifica el identificador del paquete de autenticación.

Solo se llama a LsaApCallPackage para aplicaciones de inicio de sesión; Las llamadas desde aplicaciones que no tienen el privilegio SeTcbPrivilege se enrutan a la función LsaApCallPackageUntrusted del paquete de autenticación especificada en su lugar.

Sintaxis

LSA_AP_CALL_PACKAGE LsaApCallPackage;

NTSTATUS LsaApCallPackage(
  [in]  PLSA_CLIENT_REQUEST ClientRequest,
  [in]  PVOID ProtocolSubmitBuffer,
  [in]  PVOID ClientBufferBase,
  [in]  ULONG SubmitBufferLength,
  [out] PVOID *ProtocolReturnBuffer,
  [out] PULONG ReturnBufferLength,
  [out] PNTSTATUS ProtocolStatus
)
{...}

Parámetros

[in] ClientRequest

Puntero a un búfer de LSA_CLIENT_REQUEST opaco que representa la solicitud del cliente LSA.

[in] ProtocolSubmitBuffer

Proporciona un mensaje de protocolo específico del paquete de autenticación.

[in] ClientBufferBase

Proporciona la dirección dentro del proceso de cliente del mensaje de protocolo. Esto puede ser necesario para reasignar los punteros dentro del búfer ProtocolSubmitBuffer .

[in] SubmitBufferLength

Especifica la longitud del búfer ProtocolSubmitBuffer , en bytes.

[out] ProtocolReturnBuffer

Devuelve la dirección del búfer de salida dentro del proceso de cliente. El paquete de autenticación es responsable de llamar a la función AllocateClientBuffer para asignar el búfer dentro del proceso de cliente. El contenido de este búfer es específico del paquete de autenticación.

[out] ReturnBufferLength

Puntero a un ULONG que devuelve la longitud del búfer ProtocolReturnBuffer , en bytes.

[out] ProtocolStatus

Puntero a un valor NTSTATUS. Si la función devuelve STATUS_SUCCESS, ProtocolStatus devuelve un estado de finalización establecido por el paquete de autenticación. Los valores protocolStatus son específicos del paquete de autenticación.

Puede encontrar más información sobre los códigos NTSTATUS en el archivo Subauth.h que se incluye con el SDK de plataforma.

Valor devuelto

Si la función se ejecuta correctamente, devuelva STATUS_SUCCESS. Este valor devuelto indica que el paquete de autenticación intentó proporcionar el servicio solicitado. Use el parámetro ProtocolStatus para devolver el estado de finalización de la solicitud de servicio.

Si el paquete de autenticación no pudo procesar la solicitud y, por lo tanto, no intentó proporcionar el servicio solicitado, devuelva un código NTSTATUS que indique el problema. Este código puede ser el siguiente valor o uno de los valores devueltos de la función de directiva LSA.

Código devuelto	Descripción
STATUS_NO_MEMORY	La cuota de memoria del cliente no es suficiente para asignar el búfer de salida.

Comentarios

Los paquetes de autenticación deben implementar esta función.

Requisitos

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

AllocateClientBuffer

LsaApCallPackageUntrusted

LsaCallAuthenticationPackage