IShellLibrary::AddFolder-Methode (shobjidl_core.h)

Artikel
03/13/2024

Fügt der Bibliothek einen Ordner hinzu.

Syntax

HRESULT AddFolder(
  [in] IShellItem *psiLocation
);

Parameter

[in] psiLocation

Typ: IShellItem*

Ein IShellItem-Objekt , das den Ordner darstellt, der der Bibliothek hinzugefügt werden soll.

Rückgabewert

Typ: HRESULT

Wenn diese Methode erfolgreich ist, wird S_OK zurückgegeben. Andernfalls wird ein Fehlercode HRESULT zurückgegeben.

Hinweise

Wenn ein Ordner zu einer Bibliothek hinzugefügt wird, wird er auch dem Windows Search-Index hinzugefügt.

Der Einfachheit halber kann SHAddFolderPathToLibrary anstelle dieser Methode verwendet werden.

Beispiele

Das folgende Codebeispiel zeigt die Hilfsfunktion SHAddFolderPathToLibrary, die diese Methode umschließt.

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

Anforderungen

Anforderung	Wert
Unterstützte Mindestversion (Client)	Windows 7 [nur Desktop-Apps]
Unterstützte Mindestversion (Server)	Windows Server 2008 R2 [nur Desktop-Apps]
Zielplattform	Windows
Kopfzeile	shobjidl_core.h (einschließlich Shobjidl.h)