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

See also

IoRegisterDeviceInterface

IoAssignArcName

IoCreateUnprotectedSymbolicLink

IoDeleteSymbolicLink

Send comments about this topic to Microsoft