Expand Minimize

IoCreateSymbolicLink routine

The IoCreateSymbolicLink routine sets up a symbolic link between a device object name and a user-visible name for the device.

Syntax


NTSTATUS IoCreateSymbolicLink(
  _In_  PUNICODE_STRING SymbolicLinkName,
  _In_  PUNICODE_STRING DeviceName
);

Parameters

SymbolicLinkName [in]

Pointer to a buffered Unicode string that is the user-visible name.

DeviceName [in]

Pointer to a buffered Unicode string that is the name of the driver-created device object.

Return value

IoCreateSymbolicLink returns STATUS_SUCCESS if the symbolic link object was created.

Remarks

WDM drivers do not name device objects and therefore should not use this routine. Instead, a WDM driver should call IoRegisterDeviceInterface to set up a symbolic link.

For more information about when to use IoCreateSymbolicLink, see Named Device Objects.

Requirements

Version

Available starting with Windows 2000.

Header

Wdm.h (include Wdm.h, Ntddk.h, or Ntifs.h)

Library

Ntoskrnl.lib

IRQL

PASSIVE_LEVEL

DDI compliance rules

IrqlIoPassive3, PowerIrpDDis, HwStorPortProhibitedDDIs

See also

IoRegisterDeviceInterface
IoAssignArcName
IoCreateUnprotectedSymbolicLink
IoDeleteSymbolicLink

 

 

Send comments about this topic to Microsoft

Show:
© 2015 Microsoft