Metodo IShellLibrary::RemoveFolder (shobjidl_core.h)

Articolo
08/26/2023

Rimuove una cartella dalla libreria.

Sintassi

HRESULT RemoveFolder(
  [in] IShellItem *psiLocation
);

Parametri

[in] psiLocation

Tipo: IShellItem*

Oggetto IShellItem che rappresenta la cartella da rimuovere.

Valore restituito

Tipo: HRESULT

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

Commenti

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

Esempio

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

//
// from shobjidl.h
//
__inline HRESULT SHRemoveFolderPathFromLibrary(
    __in IShellLibrary *plib,
    __in PCWSTR pszFolderPath)
{
    PIDLIST_ABSOLUTE pidlFolder = 
      SHSimpleIDListFromPath (pszFolderPath);
    HRESULT hr = pidlFolder ? S_OK : E_INVALIDARG;

    if (SUCCEEDED(hr))
    {
        IShellItem *psiFolder;
        hr = SHCreateItemFromIDList (
          pidlFolder, 
          IID_PPV_ARGS(&psiFolder));

        if (SUCCEEDED(hr))
        {
            hr = plib->RemoveFolder(psiFolder);
            psiFolder->Release();
        }
        CoTaskMemFree(pidlFolder);
    }
    return hr;
}

Requisiti


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)