IFileDialog2::SetNavigationRoot メソッド (shobjidl.h)

名前空間の参照を開始する最上位レベルの場所を指定します。たとえば、[ 保存 ] ダイアログの [フォルダーの 参照] オプションを使用します。ユーザーはこの場所の上を移動できません。

構文

HRESULT SetNavigationRoot(
  [in] IShellItem *psi
);

[in] psi

種類: IShellItem

ナビゲーションルートを表す IShellItem オブジェクトへのポインター。

種類: HRESULT

このメソッドは、成功すると S_OK を返します。そうでない場合は、HRESULT エラーコードを返します。

SetNavigationRoot は、シェル名前空間の特定の領域へのナビゲーションを制限するアプリケーションで使用できます。ナビゲーションウィンドウ内の項目は、指定された項目に置き換えられ、ユーザーが名前空間のこの部分の外部を移動するのを防がることができます。

ダイアログが表示されている間は、このメソッドを呼び出すことができません。

要件	値
サポートされている最小のクライアント	Windows 7 [デスクトップアプリのみ]
サポートされている最小のサーバー	Windows Server 2008 R2 [デスクトップアプリのみ]
対象プラットフォーム	Windows
ヘッダー	shobjidl.h
Library	Comdlg32.lib
[DLL]	Comdlg32.dll (バージョン 6.1 以降)