ZwAllocateLocallyUniqueId 関数 (ntddk.h)
ZwAllocateLocallyUniqueId ルーチンは、ローカル一意識別子 (LUID) を割り当てます。
構文
NTSYSAPI NTSTATUS ZwAllocateLocallyUniqueId(
PLUID Luid
);
パラメーター
Luid
ソース LUID 構造体のコピーを受け取る呼び出し元割り当てバッファーへのポインター。 バッファーは、少なくとも sizeof(LUID) である必要があります。
戻り値
ZwAllocateLocallyUniqueId は、操作が成功した場合はSTATUS_SUCCESSを返し、操作が失敗した場合は適切な NTSTATUS 値を返します。 出力パラメーターを 書き込むことができない場合、ルーチンは STATUS_ACCESS_VIOLATIONを返します。
注釈
割り当てられた LUID はローカル・システムのみに固有であり、一意性は、システムが次回再始動されるまでのみ保証されます。
ZwAllocateLocallyUniqueId 関数の呼び出しがユーザー モードで発生する場合は、"ZwAllocateLocallyUniqueId" の代わりに "NtAllocateLocallyUniqueId" という名前を使用する必要があります。
カーネル モード ドライバーからの呼び出しの場合、Windows ネイティブ システム サービス ルーチンの NtXxx および ZwXxx バージョンは、入力パラメーターを処理および解釈する方法で動作が異なる場合があります。 ルーチンの NtXxx バージョンと ZwXxx バージョンの間の関係の詳細については、「ネイティブ システム サービス ルーチンの Nt バージョンと Zw バージョンの使用」を参照してください。
要件
| 要件 | 値 |
|---|---|
| 対象プラットフォーム | ユニバーサル |
| Header | ntddk.h (Ntddk.h を含む) |
| Library | NtosKrnl.lib |
| [DLL] | NtosKrnl.exe |
| IRQL | PASSIVE_LEVEL |
| DDI コンプライアンス規則 | HwStorPortProhibitedDDIs(storport)、 PowerIrpDDis(wdm)、 SpNoWait(storport)、 StorPortStartIo(storport) |