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

Artículo
08/26/2023

Quita una carpeta de la biblioteca.

Sintaxis

HRESULT RemoveFolder(
  [in] IShellItem *psiLocation
);

Parámetros

[in] psiLocation

Tipo: IShellItem*

Objeto IShellItem que representa la carpeta que se va a quitar.

Valor devuelto

Tipo: HRESULT

Si este método se realiza correctamente, devuelve S_OK. De lo contrario, devuelve un código de error de HRESULT.

Comentarios

Para mayor comodidad, se puede usar SHRemoveFolderPathFromLibrary en lugar de este método.

Ejemplos

En el ejemplo de código siguiente se muestra la función auxiliar SHRemoveFolderPathFromLibrary, que encapsula este método.

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

Requisitos


Cliente mínimo compatible	Windows 7 [solo aplicaciones de escritorio]
Servidor mínimo compatible	Windows Server 2008 R2 [solo aplicaciones de escritorio]
Plataforma de destino	Windows
Encabezado	shobjidl_core.h (include Shobjidl.h)