共用方式為


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 原生系統服務例程的 NtXxxZwXxx 版本在處理和解譯輸入參數的方式可能會有不同的行為。 如需例程 NtXxxZwXxx 版本之間的關聯性詳細資訊,請參閱 使用 Nt 和 Zw 版本的原生系統服務例程

規格需求

需求
目標平台 Universal
標頭 ntddk.h (包含 Ntddk.h)
程式庫 NtosKrnl.lib
Dll NtosKrnl.exe
IRQL PASSIVE_LEVEL
DDI 合規性規則 HwStorPortProhibitedDDIs (storport) PowerIrpDDis (wdm ) 、 SpNoWait (storport ) 、 StorPortStartIo (storport)

另請參閱

LUID

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