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 命令作和重新指派它們。
一般而言,驅動程式應該呼叫此例程,而不是 IoCreateSymbolicLink 如果受保護的子系統可讓使用者變更具名裝置參考的內容,例如,使用 LPT1 存取網路印表機時。
如需何時使用 IoCreateSymbolicLink的詳細資訊,請參閱 具名裝置物件。
要求
要求 | 價值 |
---|---|
最低支援的用戶端 | 從 Windows 2000 開始提供。 |
目標平臺 | 普遍 |
標頭 | wdm.h (包括 Wdm.h、Ntddk.h、Ntifs.h) |
連結庫 | NtosKrnl.lib |
DLL | NtosKrnl.exe |
IRQL | PASSIVE_LEVEL |
DDI 合規性規則 | HwStorPortProhibitedDIs(storport)、IrqlIoPassive4(wdm)、PowerIrpDDis(wdm) |