IShellLibrary：：AddFolder 方法 (shobjidl_core.h)

發行項
03/05/2024

將資料夾新增至文件庫。

語法

HRESULT AddFolder(
  [in] IShellItem *psiLocation
);

參數

[in] psiLocation

類型： IShellItem*

IShellItem 物件，表示要加入至文檔庫的資料夾。

傳回值

類型： HRESULT

如果此方法成功，則會傳回 S_OK。否則，它會傳回 HRESULT 錯誤碼。

備註

將資料夾新增至文檔庫時，也會新增至 Windows 搜尋服務索引。

為了方便起見， 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)