IShellLibrary::AddFolder 方法 (shobjidl_core.h)

將資料夾新增至文件庫。

語法

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)

另請參閱

IShellLibrary

IShellLibrary::LoadLibraryFromItem

IShellLibrary::LoadLibraryFromKnownFolder

IShellLibrary::RemoveFolder

連結庫描述架構

SHAddFolderPathToLibrary

SHLoadLibraryFromItem

SHLoadLibraryFromKnownFolder

SHLoadLibraryFromParsingName

SHRemoveFolderPathFromLibrary

Windows 媒體櫃