Метод IWDFDevice::CreateSymbolicLink (wudfddi.h)

  • Статья

[Предупреждение: UMDF 2 является последней версией UMDF и заменяет UMDF 1. Все новые драйверы UMDF должны быть написаны с помощью UMDF 2. В UMDF 1 новые функции не добавляются, а поддержка UMDF 1 в более новых версиях Windows 10 ограничена. Универсальные драйверы Windows должны использовать UMDF 2. Дополнительные сведения см. в разделе начало работы с UMDF.]

Метод CreateSymbolicLink создает символьную ссылку для устройства.

Синтаксис

HRESULT CreateSymbolicLink(
  [in] PCWSTR pSymbolicLink
);

Параметры

[in] pSymbolicLink

Указатель на строку, завершающуюся значением NULL, которая содержит имя символьной ссылки для устройства. Имя символьной ссылки должно находиться в глобальном пространстве имен DosDevices .

Возвращаемое значение

CreateSymbolicLink возвращает S_OK, если операция выполнена успешно. В противном случае этот метод возвращает один из кодов ошибок, определенных в Winerror.h.

Комментарии

Символьная ссылка — это объект файловой системы, указывающий на другой объект файловой системы. Объект, на который указывает, называется целевым объектом.

Пример использования этого метода см. в примере драйвера VirtualSerial .

Требования

Требование Значение
Дата окончания поддержки Недоступно в UMDF 2.0 и более поздних версиях.
Целевая платформа Персональный компьютер
Минимальная версия UMDF 1.5
Верхняя часть wudfddi.h (включая Wudfddi.h)
DLL WUDFx.dll

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

IWDFDevice

IWDFDevice2::CreateSymbolicLinkWithReferenceString