Метод 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 |