ZwAllocateLocallyUniqueId 函式 (ntddk.h)
ZwAllocateLocallyUniqueId 例程會在 LUID) (配置本機唯一標識符。
語法
NTSYSAPI NTSTATUS ZwAllocateLocallyUniqueId(
PLUID Luid
);
參數
Luid
呼叫端配置的緩衝區指標,以接收來源 LUID 結構的複本。 緩衝區的大小 必須至少 (LUID) 。
傳回值
如果作業成功,ZwAllocateLocallyUniqueId 會傳回STATUS_SUCCESS,如果作業失敗,則傳回適當的 NTSTATUS 值。 如果無法寫入輸出參數,例程會傳回STATUS_ACCESS_VIOLATION。
備註
配置的 LUID 僅適用於本機系統,而且只有在下次重新啟動系統之前,才保證唯一性。
如果在使用者模式中呼叫 ZwAllocateLocallyUniqueId 函式,您應該使用名稱 “NtAllocateLocallyUniqueId”,而不是 “ZwAllocateLocallyUniqueId”。
對於核心模式驅動程式的呼叫,Windows 原生系統服務例程的 NtXxx 和 ZwXxx 版本在處理和解譯輸入參數的方式可能會有不同的行為。 如需例程 NtXxx 和 ZwXxx 版本之間的關聯性詳細資訊,請參閱 使用 Nt 和 Zw 版本的原生系統服務例程。
規格需求
需求 | 值 |
---|---|
目標平台 | Universal |
標頭 | ntddk.h (包含 Ntddk.h) |
程式庫 | NtosKrnl.lib |
Dll | NtosKrnl.exe |
IRQL | PASSIVE_LEVEL |
DDI 合規性規則 | HwStorPortProhibitedDDIs (storport) 、 PowerIrpDDis (wdm ) 、 SpNoWait (storport ) 、 StorPortStartIo (storport) |