Функция ZwQuerySymbolicLinkObject (wdm.h)

  • Статья

Подпрограмма ZwQuerySymbolicLinkObject возвращает строку Юникода, содержащую целевой объект символьной ссылки.

Синтаксис

NTSYSAPI NTSTATUS ZwQuerySymbolicLinkObject(
  [in]            HANDLE          LinkHandle,
  [in, out]       PUNICODE_STRING LinkTarget,
  [out, optional] PULONG          ReturnedLength
);

Параметры

[in] LinkHandle

Выполните обработку объекта символьной ссылки, к которому требуется выполнить запрос. Этот дескриптор создается путем успешного вызова ZwOpenSymbolicLinkObject.

[in, out] LinkTarget

Указатель на инициализированную строку Юникода, которая получает целевой объект символьной ссылки.

[out, optional] ReturnedLength

содержит максимальное количество байтов для копирования в строку Юникода в LinkTarget. В выходных данных длинное целое число без знака содержит длину строки Юникода, именующей целевой объект символьной ссылки.

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

ZwQuerySymbolicLinkObject возвращает либо STATUS_SUCCESS, чтобы указать, что подпрограмма завершена без ошибок, либо STATUS_BUFFER_TOO_SMALL, если строка Юникода, указанная в LinkTarget , слишком мала для хранения возвращаемой строки.

Комментарии

Перед вызовом этой подпрограммы средства записи драйверов должны убедиться, что строка Юникода в LinkTarget правильно инициализирована и выделен буфер для строки. Элементы MaximumLength и Buffer строки Юникода должны быть заданы перед вызовом ZwQuerySymbolicLinkObject , иначе вызов завершится ошибкой.

Если ZwQuerySymbolicLinkObject возвращает STATUS_BUFFER_TOO_SMALL драйверы должны проверять значение, возвращаемое в ReturnedLength. Число, возвращаемое в этой переменной, указывает максимальную длину строки Юникода для целевого объекта символьной ссылки.

Если вызов этой функции происходит в пользовательском режиме, следует использовать имя NtQuerySymbolicLinkObject вместо ZwQuerySymbolicLinkObject.

Для вызовов из драйверов режима ядра версии NtXxx и ZwXxx подпрограммы собственных системных служб Windows могут вести себя по-разному, так как они обрабатывают и интерпретируют входные параметры. Дополнительные сведения о связи между версиями процедуры NtXxx и ZwXxx см. в разделе Использование версий Nt и Zw для процедур собственных системных служб.

Требования

Требование Значение
Целевая платформа Универсальное
Верхняя часть wdm.h (включая Wdm.h, Ntddk.h, Ntifs.h)
Библиотека NtosKrnl.lib
DLL NtosKrnl.exe
IRQL PASSIVE_LEVEL
Правила соответствия DDI HwStorPortProhibitedDDIs(storport), PowerIrpDDis(wdm)

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

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

ZwOpenSymbolicLinkObject