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

Adiciona uma pasta à biblioteca.

Sintaxe

HRESULT AddFolder(
  [in] IShellItem *psiLocation
);

Parâmetros

[in] psiLocation

Tipo: IShellItem*

Um objeto IShellItem que representa a pasta a ser adicionada à biblioteca.

Retornar valor

Tipo: HRESULT

Se o método for bem-sucedido, ele retornará S_OK. Caso contrário, ele retornará um código de erro HRESULT.

Comentários

Quando uma pasta é adicionada a uma biblioteca, ela também é adicionada ao índice do Windows Search .

Para sua conveniência, SHAddFolderPathToLibrary pode ser usado no lugar desse método.

Exemplos

O exemplo de código a seguir mostra a função auxiliar SHAddFolderPathToLibrary, que encapsula esse 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

Confira também

Ishelllibrary

IShellLibrary::LoadLibraryFromItem

IShellLibrary::LoadLibraryFromKnownFolder

IShellLibrary::RemoveFolder

Esquema de descrição da biblioteca

SHAddFolderPathToLibrary

SHLoadLibraryFromItem

SHLoadLibraryFromKnownFolder

SHLoadLibraryFromParsingName

SHRemoveFolderPathFromLibrary

Bibliotecas do Windows