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 開始提供。 |
| 目標平台 | Universal |
| 標頭 | wdm.h (包括 Wdm.h、Ntddk.h、Ntifs.h) |
| 程式庫 | NtosKrnl.lib |
| Dll | NtosKrnl.exe |
| IRQL | PASSIVE_LEVEL |
| DDI 合規性規則 | HwStorPortProhibitedDIS (storport) 、 IrqlIoPassive4 (wdm) 、 PowerIrpDDis (wdm) |