Freigeben über


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)

Weitere Informationen

IoAssignArcName

IoCreateUnprotectedSymbolicLink

IoDeleteSymbolicLink

IoRegisterDeviceInterface