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