Note
Access to this page requires authorization. You can try signing in or changing directories.
Access to this page requires authorization. You can try changing directories.
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) |