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