Win32 API 日本語リファレンス
ホーム › Security.Authentication.Identity › PLSA_FREE_CLIENT_BUFFER

PLSA_FREE_CLIENT_BUFFER

コールバック

シグネチャ

NTSTATUS PLSA_FREE_CLIENT_BUFFER(
    void** ClientRequest,
    void* ClientBaseAddress
);

パラメーター

フィールド型説明
ClientRequestvoid**LSA クライアントの要求に関する情報を格納する、不透明な LSA_CLIENT_REQUEST データ型へのポインターです。
ClientBaseAddressvoid*省略可能です。解放するバッファーへのポインターです。このアドレスは、現在のプロセスではなくクライアントプロセス内におけるバッファーの仮想アドレスです。NULL を渡した場合、メモリは解放されません。これにより、クライアントは LSA が実際にバッファーを割り当てたかどうかを知らなくても、LSA から返された値をそのまま渡すことができます。

公式ドキュメント

以前に AllocateClientBuffer 関数で割り当てられたクライアントバッファーを解放します。

戻り値

関数が成功した場合、戻り値は STATUS_SUCCESS です。

関数が失敗した場合、戻り値は NTSTATUS コードです。詳細については、 LSA ポリシー関数の戻り値を参照してください。

LsaNtStatusToWinError 関数は、NTSTATUS コードを Windows エラーコードに変換します。

解説(Remarks)

この関数はクライアントのプロセス内のページを解放するため、呼び出しには細心の注意が必要です。有効でないアドレスを指定してこの関数を呼び出すと、クライアントプロセスがクラッシュする可能性があります。

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