共用方式為


IoCreateSymbolicLink 函式 (wdm.h)

IoCreateSymbolicLink 例程會設定裝置物件名稱與裝置用戶可見名稱之間的符號連結。

語法

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

參數

[in] SymbolicLinkName

緩衝 Unicode 字串的指標,該字串是使用者可見的名稱。

[in] DeviceName

緩衝 Unicode 字串的指標,該字串是驅動程式建立裝置物件的名稱。

傳回值

如果建立符號連結物件,IoCreateSymbolicLink 會傳回STATUS_SUCCESS。

備註

WDM 驅動程式不會命名裝置物件,因此不應該使用此例程。 相反地,WDM 驅動程式應該呼叫 IoRegisterDeviceInterface 來設定符號連結。

如需何時使用 IoCreateSymbolicLink的詳細資訊,請參閱 具名裝置物件

規格需求

需求
最低支援的用戶端 從 Windows 2000 開始提供。
目標平台 Universal
標頭 wdm.h (包括 Wdm.h、Ntddk.h、Ntifs.h)
程式庫 NtosKrnl.lib
Dll NtosKrnl.exe
IRQL PASSIVE_LEVEL
DDI 合規性規則 HwStorPortProhibitedDDIs (storport) IrqlIoPassive3 (wdm) PowerIrpDDis (wdm)

另請參閱

IoAssignArcName

IoCreateUnprotectedSymbolicLink

IoDeleteSymbolicLink

IoRegisterDeviceInterface