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