IoCreateSymbolicLink
The IoCreateSymbolicLink routine sets up a symbolic link between a device object name and a user-visible name for the device.
NTSTATUS
IoCreateSymbolicLink(
IN PUNICODE_STRING SymbolicLinkName ,
IN PUNICODE_STRING DeviceName
);
- Pointer to a buffered Unicode string that is the user-visible name. DeviceName
- Pointer to a buffered Unicode string that is the name of the driver-created device object.
Parameters
SymbolicLinkNameReturn Value
IoCreateSymbolicLink returns STATUS_SUCCESS if the symbolic link object was created.
Comments
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
IRQL: PASSIVE_LEVEL
Headers: Declared in Wdm.h . Include Wdm.h , Ntddk.h , or Ntifs.h .