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)