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 本机系统服务例程的 NtXxx 和 ZwXxx 版本在处理和解释输入参数的方式上的行为可能有所不同。 有关例程的 NtXxx 和 ZwXxx 版本之间的关系的详细信息，请参阅 使用本机系统服务例程的 Nt 和 Zw 版本。
要求
| 要求 | 值 |
|---|---|
| 目标平台 | 通用 |
| 标头 | ntddk.h (包括 Ntddk.h) |
| Library | NtosKrnl.lib |
| DLL | NtosKrnl.exe |
| IRQL | PASSIVE_LEVEL |
| DDI 符合性规则 | HwStorPortProhibitedDDI (storport) 、 PowerIrpDDis (wdm) 、 SpNoWait (storport) 、 StorPortStartIo (storport) |