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

Weitere Informationen

IWDFDevice

IWDFDevice2::CreateSymbolicLinkWithReferenceString