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

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

IoAssignArcName

IoCreateUnprotectedSymbolicLink

IoDeleteSymbolicLink

IoRegisterDeviceInterface