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)