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

  • Статья

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

Синтаксис

NTSTATUS IoCreateUnprotectedSymbolicLink(
  [in] PUNICODE_STRING SymbolicLinkName,
  [in] PUNICODE_STRING DeviceName
);

Параметры

[in] SymbolicLinkName

Предоставляет имя символьной ссылки в виде строки Юникода.

[in] DeviceName

Предоставляет имя объекта устройства, на который ссылается имя символьной ссылки.

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

IoCreateUnprotectedSymbolicLink возвращает окончательное состояние операции.

Комментарии

Драйверы WDM не называют объекты устройств и поэтому не должны использовать эту подпрограмму. Вместо этого драйвер WDM должен вызвать IoRegisterDeviceInterface , чтобы настроить символьную ссылку.

IoCreateUnprotectedSymbolicLink может использоваться драйверами, если пользователь должен иметь возможность управлять символьной ссылкой. Например, параллельные и последовательные драйверы создают незащищенные символьные ссылки для LPTx и COMx, чтобы пользователи могли управлять ими и переназначить их с помощью команды MODE.

Как правило, драйверы должны вызывать эту подпрограмму вместо IoCreateSymbolicLink , если защищенная подсистема позволяет конечным пользователям изменить то, что ссылается на именованное устройство, например при использовании LPT1 для доступа к сетевому принтеру.

Дополнительные сведения об использовании IoCreateSymbolicLink см. в разделе Именованные объекты устройства.

Требования

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

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

IoAssignArcName

IoCreateSymbolicLink

IoDeleteSymbolicLink

IoRegisterDeviceInterface