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 以降で使用できます。 |
| 対象プラットフォーム | ユニバーサル |
| Header | wdm.h (Wdm.h、Ntddk.h、Ntifs.h を含む) |
| Library | NtosKrnl.lib |
| [DLL] | NtosKrnl.exe |
| IRQL | PASSIVE_LEVEL |
| DDI コンプライアンス規則 | HwStorPortProhibitedDDIs(storport), IrqlIoPassive3(wdm), PowerIrpDDis(wdm) |