Metodo IShellLibrary::AddFolder (shobjidl_core.h)

Articolo
08/26/2023

Aggiunge una cartella alla libreria.

Sintassi

HRESULT AddFolder(
  [in] IShellItem *psiLocation
);

Parametri

[in] psiLocation

Tipo: IShellItem*

Oggetto IShellItem che rappresenta la cartella da aggiungere alla libreria.

Valore restituito

Tipo: HRESULT

Se questo metodo ha esito positivo, restituisce S_OK. In caso contrario, restituisce un codice di errore HRESULT .

Commenti

Quando una cartella viene aggiunta a una libreria, viene aggiunta anche all'indice di Windows Search .

Per praticità, è possibile usare SHAddFolderPathToLibrary al posto di questo metodo.

Esempio

Nell'esempio di codice seguente viene illustrata la funzione helper SHAddFolderPathToLibrary, che esegue il wrapping di questo metodo.

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

Requisiti

Requisito	Valore
Client minimo supportato	Windows 7 [solo app desktop]
Server minimo supportato	Windows Server 2008 R2 [solo app desktop]
Piattaforma di destinazione	Windows
Intestazione	shobjidl_core.h (include Shobjidl.h)