Функция 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 (include Wdm.h, Ntddk.h, Ntifs.h) |
| библиотеки | NtosKrnl.lib |
| DLL | NtosKrnl.exe |
| IRQL | PASSIVE_LEVEL |
| правил соответствия DDI | HwStorPortProhibitedDDIs(storport), IrqlIoPassive4(wdm), PowerIrpDDis(wdm) |