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

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

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

Синтаксис

NTSYSAPI NTSTATUS ZwAllocateLocallyUniqueId(
  PLUID Luid
);

Параметры

Luid

Указатель на выделенный вызывающим буфером для получения копии исходной структуры LUID. Буфер должен быть не менее размера(LUID).

Возвращаемое значение

ZwAllocateLocallyUniqueId возвращает STATUS_SUCCESS, если операция завершается успешно или соответствующее значение NTSTATUS, если операция завершается ошибкой. Если выходной параметр не может быть записан, подпрограмма возвращает STATUS_ACCESS_VIOLATION.

Замечания

Выделенный LUID является уникальным только для локальной системы, и уникальность гарантируется только до следующего перезапуска системы.

Если вызов функции ZwAllocateLocateLocallyUniqueId происходит в пользовательском режиме, следует использовать имя "NtAllocateLocallyUniqueId" вместо "ZwAllocateLocallyUniqueId".

Для вызовов драйверов в режиме ядра NtXxx и ZwXxx версии подпрограммы Windows Native System Services могут вести себя по-разному в том, как они обрабатывают и интерпретируют входные параметры. Дополнительные сведения о связи между NtXxx и ZwXxx версиями подпрограммы см. в разделе Using Nt and Zw Versions of the Native System Services Routines.

Требования

Требование Ценность
целевая платформа Всеобщий
заголовка ntddk.h (include Ntddk.h)
библиотеки NtosKrnl.lib
DLL NtosKrnl.exe
IRQL PASSIVE_LEVEL
правил соответствия DDI HwStorPortProhibitedDDIs(storport), PowerIrpDDis(wdm), SpNoWait(storport), StorPortStartIo(storport)

См. также

LUID

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

  • Last updated on