Método IShellLibrary::AddFolder (shobjidl_core.h)

Artículo
03/02/2024

Agrega una carpeta a la biblioteca.

Sintaxis

HRESULT AddFolder(
  [in] IShellItem *psiLocation
);

Parámetros

[in] psiLocation

Tipo: IShellItem*

Objeto IShellItem que representa la carpeta que se va a agregar a la biblioteca.

Valor devuelto

Tipo: HRESULT

Si este método se realiza correctamente, devuelve S_OK. De lo contrario, devuelve un código de error de HRESULT.

Comentarios

Cuando se agrega una carpeta a una biblioteca, también se agrega al índice de Windows Search .

Para mayor comodidad, shAddFolderPathToLibrary se puede usar en lugar de este método.

Ejemplos

En el ejemplo de código siguiente se muestra la función auxiliar SHAddFolderPathToLibrary, que encapsula este método.

//
// 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;
}

Requisitos

Requisito	Value
Cliente mínimo compatible	Windows 7 [solo aplicaciones de escritorio]
Servidor mínimo compatible	Windows Server 2008 R2 [solo aplicaciones de escritorio]
Plataforma de destino	Windows
Encabezado	shobjidl_core.h (include Shobjidl.h)