Функция IoCreateSymbolicLink (wdm.h)
Подпрограмма IoCreateSymbolicLink настраивает символьную связь между именем объекта устройства и именем, видимым пользователем для устройства.
Синтаксис
NTSTATUS IoCreateSymbolicLink(
[in] PUNICODE_STRING SymbolicLinkName,
[in] PUNICODE_STRING DeviceName
);
Параметры
[in] SymbolicLinkName
Указатель на буферизоваемую строку Юникода, которая является видимым для пользователя именем.
[in] DeviceName
Указатель на буферизоваемую строку Юникода, которая является именем созданного драйвером объекта устройства.
Возвращаемое значение
IoCreateSymbolicLink возвращает STATUS_SUCCESS, если был создан объект символьной ссылки.
Комментарии
Драйверы WDM не называют объекты устройств и поэтому не должны использовать эту подпрограмму. Вместо этого драйвер WDM должен вызвать IoRegisterDeviceInterface , чтобы настроить символьную ссылку.
Дополнительные сведения об использовании IoCreateSymbolicLink см. в разделе Именованные объекты устройств.
Требования
| Требование | Значение |
|---|---|
| Минимальная версия клиента | Доступно начиная с Windows 2000. |
| Целевая платформа | Универсальное |
| Верхняя часть | wdm.h (включая Wdm.h, Ntddk.h, Ntifs.h) |
| Библиотека | NtosKrnl.lib |
| DLL | NtosKrnl.exe |
| IRQL | PASSIVE_LEVEL |
| Правила соответствия DDI | HwStorPortProhibitedDDIs(storport), IrqlIoPassive3(wdm), PowerIrpDDis(wdm) |