Compartir a través de

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

  • Artículo

La función dispatch para las solicitudes de inicio de sesión de paso a través enviadas a la función LsaCallAuthenticationPackage .

Sintaxis

LSA_AP_CALL_PACKAGE_PASSTHROUGH LsaApCallPackagePassthrough;

NTSTATUS LsaApCallPackagePassthrough(
  [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 específico del protocolo al 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 punteros dentro de ProtocolSubmitBuffer.

[in] SubmitBufferLength

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

[out] ProtocolReturnBuffer

Devuelve la dirección del búfer de salida en el proceso de cliente. El paquete de autenticación es responsable de llamar a la función AllocateClientBuffer para asignar el búfer en el 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

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

AllocateClientBuffer

LsaCallAuthenticationPackage