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. UMDF 1 werden keine neuen Features hinzugefügt, und die Unterstützung für UMDF 1 für neuere Versionen von Windows 10 ist eingeschränkt. 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-beendete Zeichenfolge, die den Namen der symbolischen Verknüpfung für das Gerät enthält. Der symbolische Linkname 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.
Hinweise
Bei einer symbolischen Verknüpfung handelt es sich um 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 VirtualSerial-Treiberbeispiel .
Anforderungen
| Anforderung | Wert |
|---|---|
| Ende des Supports | In UMDF 2.0 und höher nicht verfügbar. |
| Zielplattform | Desktop |
| UMDF-Mindestversion | 1.5 |
| Kopfzeile | wudfddi.h (include Wudfddi.h) |
| DLL | WUDFx.dll |