IShellLibrary：：AddFolder 方法 (shobjidl_core.h)

项目
03/13/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)