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 開始提供。 |
目標平臺 | 普遍 |
標頭 | wdm.h (包括 Wdm.h、Ntddk.h、Ntifs.h) |
連結庫 | NtosKrnl.lib |
DLL | NtosKrnl.exe |
IRQL | PASSIVE_LEVEL |
DDI 合規性規則 | HwStorPortProhibitedDIs(storport)、IrqlIoPassive3(wdm)、PowerIrpDDis(wdm) |