IoCreateSymbolicLink function (wdm.h)
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
[in] SymbolicLinkName
Pointer to a buffered Unicode string that is the user-visible name.
[in] DeviceName
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
| Requirement | Value |
|---|---|
| Minimum supported client | Available starting with Windows 2000. |
| Target Platform | Universal |
| Header | wdm.h (include Wdm.h, Ntddk.h, Ntifs.h) |
| Library | NtosKrnl.lib |
| DLL | NtosKrnl.exe |
| IRQL | PASSIVE_LEVEL |
| DDI compliance rules | HwStorPortProhibitedDDIs(storport), IrqlIoPassive3(wdm), PowerIrpDDis(wdm) |