IWDFDevice::CreateSymbolicLink method (wudfddi.h)

[Warning: UMDF 2 is the latest version of UMDF and supersedes UMDF 1. All new UMDF drivers should be written using UMDF 2. No new features are being added to UMDF 1 and there is limited support for UMDF 1 on newer versions of Windows 10. Universal Windows drivers must use UMDF 2. For more info, see Getting Started with UMDF.]

The CreateSymbolicLink method creates a symbolic link for the device.

Syntax

HRESULT CreateSymbolicLink(
  [in] PCWSTR pSymbolicLink
);

Parameters

[in] pSymbolicLink

A pointer to a NULL-terminated string that contains the name of the symbolic link for the device. The symbolic link name must be in the global DosDevices namespace.

Return value

CreateSymbolicLink returns S_OK if the operation succeeds. Otherwise, this method returns one of the error codes that are defined in Winerror.h.

Remarks

A symbolic link is a file-system object that points to another file-system object. The object being pointed to is called the target.

For an example usage of this method, see the VirtualSerial driver sample.

Requirements

Requirement Value
End of support Unavailable in UMDF 2.0 and later.
Target Platform Desktop
Minimum UMDF version 1.5
Header wudfddi.h (include Wudfddi.h)
DLL WUDFx.dll

See also

IWDFDevice

IWDFDevice2::CreateSymbolicLinkWithReferenceString