ZwAllocateLocallyUniqueId 函数 (ntddk.h)

ZwAllocateLocallyUniqueId 例程分配本地唯一标识符(LUID)。

语法

NTSYSAPI NTSTATUS ZwAllocateLocallyUniqueId(
  PLUID Luid
);

参数

Luid

指向调用方分配的缓冲区的指针,用于接收源 LUID 结构的副本。 缓冲区必须至少 大小LUID)。

返回值

如果作成功,ZwAllocateLocallyUniqueId 返回STATUS_SUCCESS;如果作失败,则返回相应的 NTSTATUS 值。 如果输出参数无法写入,则例程将返回STATUS_ACCESS_VIOLATION。

言论

分配 LUID 仅对本地系统是唯一的,并且仅在系统下次重启之前保证唯一性。

如果在用户模式下调用 ZwAllocateLocallyUniqueId 函数,则应使用名称“NtAllocateLocallyUniqueId”而不是“ZwAllocateLocallyUniqueId”。

对于内核模式驱动程序的调用,NtXxxZwXxx 版本的 Windows 本机系统服务例程的行为方式可能以不同的方式处理和解释输入参数。 有关 NtXxxZwXxx 例程之间的关系的详细信息,请参阅 使用 Nt 和 Zw 版本的本机系统服务例程

要求

要求 价值
目标平台 普遍
标头 ntddk.h (包括 Ntddk.h)
NtosKrnl.lib
DLL NtosKrnl.exe
IRQL PASSIVE_LEVEL
DDI 符合性规则 HwStorPortProhibitedDDIs(storport)PowerIrpDDis(wdm)SpNoWait(storport)StorPortStartIo(storport)

另请参阅

LUID

使用本机系统服务例程的 Nt 和 Zw 版本