IO Create Symbolic Link

IO Create Sym bolic Link

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

    );

Parameters

SymbolicLinkName

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

Return Value

IoCreateSymbolicLink returns STATUS_SUCCESS if the symbolic link object was created

Headers

Declared in wdm.h and ntddk.h Include wdm.h or ntddk.h

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

Callers of IoCreateSymbolicLink must be running at IRQL = PASSIVE_LEVEL

See Also

IoRegisterDeviceInterface, IoAssignArcName, IoCreateUnprotectedSymbolicLink,

IoDeleteSymbolicLink

© Microsoft Corporation Send feedback on this topic

Built on Friday, February 18, 2005

Kernel-Mode Driver Architecture: Windows DDK

Page 1 of 1 IoCreateSymbolicLink

9/19/2010 mk:@MSITStore:E:\WINDDK\3790.1830\help\kmarch.chm::/hh/kmarch/k104_8311eaf7-