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