Метод 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-terminated, содержащую имя символьной ссылки для устройства. Имя символьной ссылки должно находиться в глобальном пространстве имен DosDevices.
Возвращаемое значение
CreateSymbolicLink возвращает S_OK, если операция выполнена успешно. В противном случае этот метод возвращает один из кодов ошибок, определенных в Winerror.h.
Замечания
Символьная ссылка — это объект файловой системы, указывающий на другой объект файловой системы. Объект, на который указывает объект, называется целевым объектом.
Пример использования этого метода см. в примере драйвера VirtualSerial.
Требования
| Требование | Ценность |
|---|---|
| завершение поддержки | Недоступно в UMDF 2.0 и более поздних версиях. |
| целевая платформа | Настольный |
| минимальная версия UMDF | 1.5 |
| заголовка | wudfddi.h (include Wudfddi.h) |
| DLL | WUDFx.dll |