LSA_ALLOCATE_CLIENT_BUFFER回呼函式 (ntsecpkg.h)

  • 發行項

在客戶端的位址空間中配置緩衝區。 在用戶端位址空間中配置的緩衝區是用來保存從驗證套件傳回給客戶端的資訊。

語法

LSA_ALLOCATE_CLIENT_BUFFER LsaAllocateClientBuffer;

NTSTATUS LsaAllocateClientBuffer(
  [in]  PLSA_CLIENT_REQUEST ClientRequest,
  [in]  ULONG LengthRequired,
  [out] PVOID *ClientBaseAddress
)
{...}

參數

[in] ClientRequest

不透明 LSA_CLIENT_REQUEST 數據結構的指標，其中包含 LSA 用戶端驗證要求的相關信息。 自定義驗證套件應該會在用戶端對函式的呼叫期間傳入所收到的值，例如 LsaApCallPackage 或 LsaApLogonUser，以傳回輸出參數。

[in] LengthRequired

所需的緩衝區長度，以位元組為單位。

[out] ClientBaseAddress

接收緩衝區位址的指標。 此位址是客戶端進程內緩衝區的虛擬位址，不在目前的進程中。

傳回值

如果函式成功，傳回值會STATUS_SUCCESS。

如果函式失敗，則傳回值是NTSTATUS程式碼，可以是下列值或其中一個 LSA 原則函式傳回值。

傳回碼 Description
STATUS_NO_MEMORY
 用戶端進程沒有適當的記憶體配額來配置緩衝區。
 

LsaNtStatusToWinError 函式會將NTSTATUS程式碼轉換成 Windows 錯誤碼。

備註

驗證套件或客戶端進程之後必須釋放緩衝區。 驗證程式可以使用 FreeClientBuffer 分派例程釋放緩衝區。 用戶端程式可以使用 LsaFreeReturnBuffer 函式釋放緩衝區。

規格需求

需求 值
最低支援的用戶端 Windows XP [僅限傳統型應用程式]
最低支援的伺服器 Windows Server 2003 [僅限傳統型應用程式]
目標平台 Windows
標頭 ntsecpkg.h

另請參閱

LSA_DISPATCH_TABLE

LSA_SECPKG_FUNCTION_TABLE