IoCreateUnprotectedSymbolicLink 函数 (wdm.h)

IoCreateUnprotectedSymbolicLink 例程在设备对象名称和相应的 Win32 可见名称之间设置不受保护的符号链接。

语法

NTSTATUS IoCreateUnprotectedSymbolicLink(
  [in] PUNICODE_STRING SymbolicLinkName,
  [in] PUNICODE_STRING DeviceName
);

[in] SymbolicLinkName

以 Unicode 字符串的形式提供符号链接名称。

[in] DeviceName

提供符号链接名称所引用的设备对象的名称。

IoCreateUnprotectedSymbolicLink 返回操作的最终状态。

WDM 驱动程序不命名设备对象，因此不应使用此例程。 WDM 驱动程序应调用 IoRegisterDeviceInterface 来设置符号链接。

如果用户需要能够操作符号链接，驱动程序可以使用 IoCreateUnprotectedSymbolicLink。例如，并行和串行驱动程序为 LPTx 和 COMx 创建不受保护的符号链接，以便用户可以使用 MODE 命令操作和重新分配它们。

通常，如果受保护的子系统允许最终用户更改命名设备引用的内容，例如在使用 LPT1 访问网络打印机时，驱动程序应调用此例程而不是 IoCreateSymbolicLink 。

有关何时使用 IoCreateSymbolicLink 的详细信息，请参阅命名设备对象。

要求	值
最低受支持的客户端	从 Windows 2000 开始可用。
目标平台	通用
标头	wdm.h（包括 Wdm.h、Ntddk.h、Ntifs.h）
Library	NtosKrnl.lib
DLL	NtosKrnl.exe
IRQL	PASSIVE_LEVEL
DDI 符合性规则	HwStorPortProhibitedDDI (storport) 、 IrqlIoPassive4 (wdm) 、 PowerIrpDDis (wdm)