IoCreateUnprotectedSymbolicLink-Funktion (wdm.h)
Die IoCreateUnprotectedSymbolicLink Routine richtet eine nicht geschützte symbolische Verknüpfung zwischen einem Geräteobjektnamen und einem entsprechenden Win32-sichtbaren Namen ein.
Syntax
NTSTATUS IoCreateUnprotectedSymbolicLink(
[in] PUNICODE_STRING SymbolicLinkName,
[in] PUNICODE_STRING DeviceName
);
Parameter
[in] SymbolicLinkName
Stellt den symbolischen Verknüpfungsnamen als Unicode-Zeichenfolge bereit.
[in] DeviceName
Stellt den Namen des Geräteobjekts bereit, auf das der symbolische Verknüpfungsname verweist.
Rückgabewert
IoCreateUnprotectedSymbolicLink den endgültigen Status des Vorgangs zurück.
Bemerkungen
WDM-Treiber benennen keine Geräteobjekte und sollten daher diese Routine nicht verwenden. Stattdessen sollte ein WDM-Treiber IoRegisterDeviceInterface- aufrufen, um eine symbolische Verknüpfung einzurichten.
IoCreateUnprotectedSymbolicLink- kann von Treibern verwendet werden, wenn der Benutzer die symbolische Verknüpfung bearbeiten muss. Beispielsweise erstellen die parallelen und seriellen Treiber ungeschützte symbolische Verknüpfungen für LPTx und COMx, sodass Benutzer sie mithilfe des Befehls MODUS bearbeiten und neu zuweisen können.
Im Allgemeinen sollten Treiber diese Routine anstelle von IoCreateSymbolicLink aufrufen, wenn Endbenutzern ermöglichen, zu ändern, was ein benanntes Gerät referenziert, z. B. bei Verwendung von LPT1 für den Zugriff auf einen Netzwerkdrucker.
Weitere Informationen zur Verwendung von IoCreateSymbolicLinkfinden Sie unter Benannte Geräteobjekte.
Anforderungen
| Anforderung | Wert |
|---|---|
| mindestens unterstützte Client- | Ab Windows 2000 verfügbar. |
| Zielplattform- | Universal |
| Header- | wdm.h (include Wdm.h, Ntddk.h, Ntifs.h) |
| Library | NtosKrnl.lib |
| DLL- | NtosKrnl.exe |
| IRQL- | PASSIVE_LEVEL |
| DDI-Complianceregeln | HwStorPortProhibitedDDIs(storport), IrqlIoPassive4(wdm), PowerIrpDDis(wdm) |