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

Article
03/04/2024

Ajoute un dossier à la bibliothèque.

Syntaxe

HRESULT AddFolder(
  [in] IShellItem *psiLocation
);

Paramètres

[in] psiLocation

Type : IShellItem*

Objet IShellItem qui représente le dossier à ajouter à la bibliothèque.

Valeur retournée

Type : HRESULT

Si cette méthode réussit, elle retourne S_OK. Sinon, elle retourne un code d’erreur HRESULT.

Remarques

Lorsqu’un dossier est ajouté à une bibliothèque, il est également ajouté à l’index Recherche Windows .

Pour des raisons pratiques, SHAddFolderPathToLibrary peut être utilisé à la place de cette méthode.

Exemples

L’exemple de code suivant montre la fonction d’assistance SHAddFolderPathToLibrary, qui encapsule cette méthode.

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

Configuration requise

Condition requise	Valeur
Client minimal pris en charge	Windows 7 [applications de bureau uniquement]
Serveur minimal pris en charge	Windows Server 2008 R2 [applications de bureau uniquement]
Plateforme cible	Windows
En-tête	shobjidl_core.h (inclure Shobjidl.h)