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) |