ホーム › Security.Authentication.Identity › PLSA_AP_CALL_PACKAGE_PASSTHROUGH

PLSA_AP_CALL_PACKAGE_PASSTHROUGH

コールバック

シグネチャ

NTSTATUS PLSA_AP_CALL_PACKAGE_PASSTHROUGH(
    void** ClientRequest,
    void* ProtocolSubmitBuffer,
    void* ClientBufferBase,
    DWORD SubmitBufferLength,
    void** ProtocolReturnBuffer,
    DWORD* ReturnBufferLength,
    INT* ProtocolStatus
);

パラメーター

フィールド	型	説明
ClientRequest	void**	LSA クライアントの要求を表す、不透明な LSA_CLIENT_REQUEST バッファーへのポインターです。
ProtocolSubmitBuffer	void*	認証パッケージに対して、プロトコル固有のメッセージを渡します。
ClientBufferBase	void*	クライアントプロセス内におけるプロトコルメッセージのアドレスを指定します。これは ProtocolSubmitBuffer 内のポインターを再マップするために必要になる場合があります。
SubmitBufferLength	DWORD	ProtocolSubmitBuffer バッファーの長さをバイト単位で指定します。
ProtocolReturnBuffer	void**	クライアントプロセス内の出力バッファーのアドレスを返します。認証パッケージは、 AllocateClientBuffer 関数を呼び出して、クライアントプロセス内にバッファーを割り当てる必要があります。このバッファーの内容は認証パッケージ固有です。
ReturnBufferLength	DWORD*	ProtocolReturnBuffer バッファーの長さをバイト単位で返す ULONG へのポインターです。
ProtocolStatus	INT*	NTSTATUS 値へのポインターです。関数が STATUS_SUCCESS を返した場合、ProtocolStatus には認証パッケージが設定した完了状態が返されます。ProtocolStatus の値は認証パッケージ固有です。 NTSTATUS コードの詳細については、Platform SDK に付属する Subauth.h ファイルを参照してください。

公式ドキュメント

LsaCallAuthenticationPackage 関数に送信されたパススルーログオン要求のディスパッチ関数です。

戻り値

関数が成功した場合は STATUS_SUCCESS を返します。この戻り値は、認証パッケージが要求されたサービスの提供を試みたことを示します。サービス要求の完了状態を返すには、ProtocolStatus パラメーターを使用します。

認証パッケージが要求を処理できず、そのため要求されたサービスの提供を試みなかった場合は、問題を示す NTSTATUS コードを返します。このコードには、次の値、または LSA ポリシー関数の戻り値のいずれかを指定できます。

戻り値	説明
STATUS_NO_MEMORY	クライアントのメモリクォータが不足しているため、出力バッファーを割り当てられません。

解説(Remarks)

この関数は認証パッケージが実装する必要があります。

出典・ライセンス: 上記「公式ドキュメント」の内容は Microsoft の Win32 API ドキュメント(MicrosoftDocs/sdk-api)を日本語に翻訳・改変したものです。© Microsoft Corporation. CC BY 4.0 で提供。
Microsoft 公式リファレンス: 英語 (en-us) · 日本語 (ja-jp) · 原文ソース (GitHub)