IoCreateSymbolicLink-Funktion (wdm.h)
Die IoCreateSymbolicLink- Routine richtet eine symbolische Verknüpfung zwischen einem Geräteobjektnamen und einem für das Gerät sichtbaren Namen ein.
Syntax
NTSTATUS IoCreateSymbolicLink(
[in] PUNICODE_STRING SymbolicLinkName,
[in] PUNICODE_STRING DeviceName
);
Parameter
[in] SymbolicLinkName
Zeigen Sie auf eine gepufferte Unicode-Zeichenfolge, bei der es sich um den namen des Benutzers handelt.
[in] DeviceName
Zeigen Sie auf eine gepufferte Unicode-Zeichenfolge, die den Namen des vom Treiber erstellten Geräteobjekts darstellt.
Rückgabewert
IoCreateSymbolicLink- gibt STATUS_SUCCESS zurück, wenn das symbolische Verknüpfungsobjekt erstellt wurde.
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.
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), IrqlIoPassive3(wdm), PowerIrpDDis(wdm) |