ZwAllocateLocallyUniqueId 函数 (ntddk.h)
ZwAllocateLocallyUniqueId 例程分配本地唯一标识符(LUID)。
语法
NTSYSAPI NTSTATUS ZwAllocateLocallyUniqueId(
PLUID Luid
);
参数
Luid
指向调用方分配的缓冲区的指针,用于接收源 LUID 结构的副本。 缓冲区必须至少 大小(LUID)。
返回值
如果作成功,ZwAllocateLocallyUniqueId 返回STATUS_SUCCESS;如果作失败,则返回相应的 NTSTATUS 值。 如果输出参数无法写入,则例程将返回STATUS_ACCESS_VIOLATION。
言论
分配 LUID 仅对本地系统是唯一的,并且仅在系统下次重启之前保证唯一性。
如果在用户模式下调用 ZwAllocateLocallyUniqueId 函数,则应使用名称“NtAllocateLocallyUniqueId”而不是“ZwAllocateLocallyUniqueId”。
对于内核模式驱动程序的调用,NtXxx 和 ZwXxx 版本的 Windows 本机系统服务例程的行为方式可能以不同的方式处理和解释输入参数。 有关 NtXxx 与 ZwXxx 例程之间的关系的详细信息,请参阅 使用 Nt 和 Zw 版本的本机系统服务例程。
要求
要求 | 价值 |
---|---|
目标平台 | 普遍 |
标头 | ntddk.h (包括 Ntddk.h) |
库 | NtosKrnl.lib |
DLL | NtosKrnl.exe |
IRQL | PASSIVE_LEVEL |
DDI 符合性规则 | HwStorPortProhibitedDDIs(storport)、PowerIrpDDis(wdm)、SpNoWait(storport)、StorPortStartIo(storport) |