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 は、ユーザーがシンボリック リンクを操作できる必要がある場合に、ドライバーで使用できます。 たとえば、並列ドライバーとシリアル ドライバーは、ユーザーが MODE コマンドを使用して操作および再割り当てできるように、LPTx と COMx の保護されていないシンボリック リンクを作成します。
一般に、保護されたサブシステムでエンド ユーザーが LPT1 を使用してネットワーク プリンターにアクセスする場合など、名前付きデバイスが参照する内容を変更できる場合、ドライバーは IoCreateSymbolicLink を の代わりに、このルーチンを呼び出す必要があります。
IoCreateSymbolicLink 使用するタイミングの詳細については、「名前付きデバイス オブジェクトを参照してください。
必要条件
| 要件 | 価値 |
|---|---|
| サポートされる最小クライアント | Windows 2000 以降で使用できます。 |
| ターゲット プラットフォーム の | 万国 |
| ヘッダー | wdm.h (Wdm.h、Ntddk.h、Ntifs.h を含む) |
| ライブラリ | NtosKrnl.lib |
| DLL | NtosKrnl.exe |
| IRQL | PASSIVE_LEVEL |
| DDI コンプライアンス規則 を する | HwStorPortProhibitedDDDIs(storport), IrqlIoPassive4(wdm), PowerIrpDDis(wdm) |