IWDFDevice::CreateSymbolicLink-Methode (wudfddi.h)
[Warnung: UMDF 2 ist die neueste Version von UMDF und ersetzt UMDF 1. Alle neuen UMDF-Treiber sollten mit UMDF 2 geschrieben werden. Es werden keine neuen Features zu UMDF 1 hinzugefügt, und es gibt eingeschränkte Unterstützung für UMDF 1 für neuere Versionen von Windows 10. Universelle Windows-Treiber müssen UMDF 2 verwenden. Weitere Informationen finden Sie unter Erste Schritte mit UMDF-.]
Die CreateSymbolicLink--Methode erstellt eine symbolische Verknüpfung für das Gerät.
Syntax
HRESULT CreateSymbolicLink(
[in] PCWSTR pSymbolicLink
);
Parameter
[in] pSymbolicLink
Ein Zeiger auf eine NULL--terminated-Zeichenfolge, die den Namen der symbolischen Verknüpfung für das Gerät enthält. Der name der symbolischen Verknüpfung muss sich im globalen DosDevices Namespace befinden.
Rückgabewert
CreateSymbolicLink- gibt S_OK zurück, wenn der Vorgang erfolgreich ist. Andernfalls gibt diese Methode einen der Fehlercodes zurück, die in Winerror.h definiert sind.
Bemerkungen
Eine symbolische Verknüpfung ist ein Dateisystemobjekt, das auf ein anderes Dateisystemobjekt verweist. Das Objekt, auf das verwiesen wird, wird als Ziel bezeichnet.
Ein Beispiel für die Verwendung dieser Methode finden Sie im Beispiel VirtualSerial Treiber.
Anforderungen
| Anforderung | Wert |
|---|---|
| Ende des Supports | In UMDF 2.0 und höher nicht verfügbar. |
| Zielplattform- | Desktop |
| Mindest-UMDF-Version | 1.5 |
| Header- | wudfddi.h (include Wudfddi.h) |
| DLL- | WUDFx.dll |