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