Функция 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) |