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