IoCreateUnprotectedSymbolicLink-Funktion (wdm.h)

Die IoCreateUnprotectedSymbolicLink-Routine richtet eine ungeschützte symbolische Verknüpfung zwischen einem Geräteobjektnamen und einem entsprechenden Win32-Visible-Namen ein.

Syntax

NTSTATUS IoCreateUnprotectedSymbolicLink(
  [in] PUNICODE_STRING SymbolicLinkName,
  [in] PUNICODE_STRING DeviceName
);

Parameter

[in] SymbolicLinkName

Gibt den symbolischen Linknamen als Unicode-Zeichenfolge an.

[in] DeviceName

Gibt den Namen des Geräteobjekts an, auf das der symbolische Linkname verweist.

Rückgabewert

IoCreateUnprotectedSymbolicLink gibt die letzte status des Vorgangs zurück.

Hinweise

WDM-Treiber benennen keine Geräteobjekte und sollten daher diese Routine nicht verwenden. Stattdessen sollte ein WDM-Treiber IoRegisterDeviceInterface aufrufen, um einen symbolischen Link einzurichten.

IoCreateUnprotectedSymbolicLink kann von Treibern verwendet werden, wenn der Benutzer in der Lage sein muss, den symbolischen Link zu bearbeiten. Beispielsweise erstellen die parallelen und seriellen Treiber ungeschützte symbolische Links für LPTx und COMx, sodass Benutzer sie mithilfe des BEFEHLS MODE bearbeiten und neu zuweisen können.

Im Allgemeinen sollten Treiber diese Routine anstelle von IoCreateSymbolicLink aufrufen, wenn endbenutzer mit einem geschützten Subsystem ändern können, worauf ein benanntes Gerät verweist, z. B. wenn LPT1 für den Zugriff auf einen Netzwerkdrucker verwendet wird.

Weitere Informationen zur Verwendung von IoCreateSymbolicLink finden Sie unter Benannte Geräteobjekte.

Anforderungen

Anforderung	Wert
Unterstützte Mindestversion (Client)	Verfügbar ab Windows 2000.
Zielplattform	Universell
Header	wdm.h (einschließlich Wdm.h, Ntddk.h, Ntifs.h)
Bibliothek	NtosKrnl.lib
DLL	NtosKrnl.exe
IRQL	PASSIVE_LEVEL
DDI-Complianceregeln	HwStorPortProhibitedDIs(storport), IrqlIoPassive4(wdm), PowerIrpDDis(wdm)

Weitere Informationen

IoAssignArcName

IoCreateSymbolicLink

IoDeleteSymbolicLink

IoRegisterDeviceInterface