LSA_AP_CALL_PACKAGE_PASSTHROUGH função de retorno de chamada (ntsecpkg.h)

A função de expedição para solicitações de logon de passagem enviadas para a função LsaCallAuthenticationPackage .

Sintaxe

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

Ponteiro para um buffer de LSA_CLIENT_REQUEST opaco que representa a solicitação do cliente LSA.

[in] ProtocolSubmitBuffer

Fornece uma mensagem específica do protocolo para o pacote de autenticação.

[in] ClientBufferBase

Fornece o endereço dentro do processo do cliente da mensagem de protocolo. Isso pode ser necessário para remapear ponteiros no ProtocolSubmitBuffer.

[in] SubmitBufferLength

Especifica o comprimento do buffer ProtocolSubmitBuffer , em bytes.

[out] ProtocolReturnBuffer

Retorna o endereço do buffer de saída no processo do cliente. O pacote de autenticação é responsável por chamar a função AllocateClientBuffer para alocar o buffer no processo do cliente. O conteúdo desse buffer é específico para o pacote de autenticação.

[out] ReturnBufferLength

Ponteiro para um ULONG que retorna o comprimento do buffer ProtocolReturnBuffer , em bytes.

[out] ProtocolStatus

Ponteiro para um valor NTSTATUS. Se a função retornar STATUS_SUCCESS, ProtocolStatus retornará uma conclusão status definida pelo pacote de autenticação. Os valores protocolStatus são específicos para o pacote de autenticação.

Mais informações sobre códigos NTSTATUS podem ser encontradas no arquivo Subauth.h enviado com o SDK da Plataforma.

Retornar valor

Se a função for bem-sucedida, retorne STATUS_SUCCESS. Esse valor retornado indica que o pacote de autenticação tentou fornecer o serviço solicitado. Use o parâmetro ProtocolStatus para retornar o status de conclusão da solicitação de serviço.

Se o pacote de autenticação não pôde processar a solicitação e, portanto, não tentou fornecer o serviço solicitado, retorne um código NTSTATUS indicando o problema. Esse código pode ser o valor a seguir ou um dos valores retornados da função de política LSA.

Código de retorno	Descrição
STATUS_NO_MEMORY	A cota de memória do cliente é insuficiente para alocar o buffer de saída.

Comentários

Essa função deve ser implementada por pacotes de autenticação.

Requisitos

Requisito	Valor
Cliente mínimo com suporte	Windows XP [somente aplicativos da área de trabalho]
Servidor mínimo com suporte	Windows Server 2003 [somente aplicativos da área de trabalho]
Plataforma de Destino	Windows
Cabeçalho	ntsecpkg.h

Confira também

AllocateClientBuffer

LsaCallAuthenticationPackage