LSA_AP_CALL_PACKAGE回呼函式 (ntsecpkg.h)
當具有 LSA 信任連線的登入應用程式呼叫LsaCallAuthenticationPackage函式,並指定驗證套件的識別碼時,本機安全性授權單位會 (LSA) 呼叫。
僅針對登入應用程式呼叫LsaApCallPackage;從沒有 SeTcbPrivilege 許可權的應用程式呼叫會改為路由傳送至指定的驗證套件LsaApCallPackageUntrusted 函式。
語法
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
)
{...}
參數
[in] ClientRequest
表示 LSA 用戶端要求的不透明 LSA_CLIENT_REQUEST 緩衝區指標。
[in] ProtocolSubmitBuffer
提供驗證套件特定的通訊協定訊息。
[in] ClientBufferBase
提供通訊協定訊息用戶端進程內的位址。 您可能需要重新對應 ProtocolSubmitBuffer 緩衝區內的任何指標。
[in] SubmitBufferLength
指定 ProtocolSubmitBuffer 緩衝區的長度,以位元組為單位。
[out] ProtocolReturnBuffer
傳回用戶端進程內輸出緩衝區的位址。 驗證套件負責呼叫 AllocateClientBuffer 函式,以在用戶端進程內配置緩衝區。 此緩衝區的內容專屬於驗證套件。
[out] ReturnBufferLength
ULONG的指標,以位元組為單位傳回ProtocolReturnBuffer緩衝區的長度。
[out] ProtocolStatus
NTSTATUS 值的指標。 如果函式傳回STATUS_SUCCESS, ProtocolStatus 會傳回驗證套件所設定的完成狀態。 ProtocolStatus 值是驗證套件特有的值。
如需 NTSTATUS 程式碼的詳細資訊,請參閱平臺 SDK 隨附的 Subauth.h 檔案。
傳回值
如果函式成功,則傳回STATUS_SUCCESS。 這個傳回值表示驗證套件嘗試提供要求的服務。 使用 ProtocolStatus 參數可傳回服務要求的完成狀態。
如果驗證套件無法處理要求,因此未嘗試提供要求的服務,請傳回 NTSTATUS 程式碼,指出問題。 此程式碼可以是下列值或其中一個 LSA 原則函式傳回值。
傳回碼 | 描述 |
---|---|
|
用戶端的記憶體配額不足,無法配置輸出緩衝區。 |
備註
驗證套件必須實作此函式。
需求
最低支援的用戶端 | Windows XP [僅限傳統型應用程式] |
最低支援的伺服器 | Windows Server 2003 [僅限傳統型應用程式] |
目標平台 | Windows |
標頭 | ntsecpkg.h |