IShellLibrary::AddFolder メソッド (shobjidl_core.h)

[アーティクル]
03/05/2024

ライブラリにフォルダーを追加します。

構文

HRESULT AddFolder(
  [in] IShellItem *psiLocation
);

パラメーター

[in] psiLocation

種類: IShellItem*

ライブラリに追加するフォルダーを表す IShellItem オブジェクト。

戻り値

型: HRESULT

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

注釈

フォルダーがライブラリに追加されると、 Windows Search インデックスにも追加されます。

便宜上、このメソッドの代わりに SHAddFolderPathToLibrary を使用できます。

例

次のコード例は、このメソッドをラップするヘルパー関数 SHAddFolderPathToLibrary を示しています。

//
// From Shobjidl.h
//
__inline HRESULT SHAddFolderPathToLibrary (
    __in IShellLibrary *plib,
    __in PCWSTR pszFolderPath
)
{
    IShellItem *psiFolder;
    
    HRESULT hr = SHCreateItemFromParsingName (
      pszFolderPath, 
      NULL,
      IID_PPV_ARGS(&psiFolder));
    
    if (SUCCEEDED(hr))
    {
        hr = plib->AddFolder (psiFolder);
        psiFolder->Release ();
    }
    return hr;
}

要件

要件	値
サポートされている最小のクライアント	Windows 7 [デスクトップアプリのみ]
サポートされている最小のサーバー	Windows Server 2008 R2 [デスクトップアプリのみ]
対象プラットフォーム	Windows
ヘッダー	shobjidl_core.h (Shobjidl.h を含む)