Поделиться через


Функция ZwAllocateLocallyUniqueId (ntddk.h)

Подпрограмма ZwAllocateLocallyUniqueId выделяет локальный уникальный идентификатор (LUID).

Синтаксис

NTSYSAPI NTSTATUS ZwAllocateLocallyUniqueId(
  PLUID Luid
);

Параметры

Luid

Указатель на буфер, выделенный вызывающим объектом, для получения копии исходной структуры LUID. Буфер должен быть не ниже sizeof(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 HwStorPortProhibitedDIs(storport), PowerIrpDDis(wdm), SpNoWait(storport), StorPortStartIo(storport)

См. также раздел

LUID

Использование версий nt и Zw собственных системных служб