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

Artigo
03/02/2024

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

Requisito	Valor
Cliente mínimo com suporte	Windows 7 [somente aplicativos da área de trabalho]
Servidor mínimo com suporte	Windows Server 2008 R2 [somente aplicativos da área de trabalho]
Plataforma de Destino	Windows
Cabeçalho	shobjidl_core.h (inclua Shobjidl.h)