共用方式為


ZwAllocateLocallyUniqueId 函式 (ntddk.h)

ZwAllocateLocallyUniqueId 例程會配置本機唯一標識碼(LUID)。

語法

NTSYSAPI NTSTATUS ZwAllocateLocallyUniqueId(
  PLUID Luid
);

參數

Luid

呼叫端配置的緩衝區指標,以接收來源 LUID 結構的複本。 緩衝區必須至少 大小為LUID)。

傳回值

ZwAllocateLocallyUniqueId 如果作業成功或作業失敗,則會傳回適當的 NTSTATUS 值STATUS_SUCCESS。 如果無法寫入輸出參數,例程會傳回STATUS_ACCESS_VIOLATION。

言論

配置 LUID 只對本機系統而言是唯一的,而且只有在系統下次重新啟動之前,才會保證唯一性。

如果在使用者模式中呼叫 ZwAllocateLocallyUniqueId 函式,您應該使用名稱 “NtAllocateLocallyUniqueId”,而不是 “ZwAllocateLocallyUniqueId”。

對於內核模式驅動程式的呼叫,NtXxxZwXxx 版本的 Windows 原生系統服務例程,在處理和解譯輸入參數的方式上可能會有不同的行為。 如需 nt NtXxxZwXxx 例程之間關聯性的詳細資訊,請參閱 使用 Nt 和 Zw 版本的原生系統服務例程

要求

要求 價值
目標平臺 普遍
標頭 ntddk.h (包括 Ntddk.h)
連結庫 NtosKrnl.lib
DLL NtosKrnl.exe
IRQL PASSIVE_LEVEL
DDI 合規性規則 HwStorPortProhibitedDIS(storport)PowerIrpDDis(wdm)SpNoWait(storport)StorPortStartIo(storport)

另請參閱

LUID

使用 Nt 和 Zw 版本的原生系統服務例程