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) |