Compartir a través de

Método IWMDMStorage4::GetParent (mswmdm.h)

  • Artículo

El método GetParent recupera el elemento primario del almacenamiento.

Sintaxis

HRESULT GetParent(
  [out] IWMDMStorage **ppStorage
);

Parámetros

[out] ppStorage

Puntero a la interfaz IWMDMStorage del almacenamiento primario. El autor de la llamada debe liberar esta interfaz cuando termine con ella.

Valor devuelto

El método devuelve un valor HRESULT. Todos los métodos de interfaz de Windows Media Administrador de dispositivos pueden devolver cualquiera de las siguientes clases de códigos de error:

  • Códigos de error COM estándar
  • Códigos de error de Windows convertidos en valores HRESULT
  • Códigos de error de windows Media Administrador de dispositivos
Para obtener una lista extensa de posibles códigos de error, consulte Códigos de error.

Comentarios

La aplicación puede navegar por la jerarquía de almacenamiento mediante una llamada a GetParent de forma recursiva. Una vez alcanzado el almacenamiento raíz, GetParent devuelve S_FALSE y establece ppStorage en NULL.

Ejemplos

La siguiente función de C++ recorre hasta el elemento primario raíz de un almacenamiento.


HRESULT BubbleUp(IWMDMStorage *pIStorage)
{
    HRESULT hr = S_OK;
    CComPtr<IWMDMStorage4> pStorage4;

    hr = pIStorage->QueryInterface (__uuidof(IWMDMStorage4), reinterpret_cast<void**>(&pStorage4));
    if (SUCCEEDED(hr))
    {
        while ((pStorage4 != NULL))
        {
            CComPtr<IWMDMStorage> pParent;
            hr = pStorage4->GetParent(&pParent);
            if (FAILED(hr))
            {
                break;
            }

            //
            // Do something with pParent....
            //
            
            if (S_FALSE != hr)
            {
                hr = pParent->QueryInterface (__uuidof(IMDSPStorage4), reinterpret_cast<void**>(&pStorage4));
                if (FAILED(hr))
                {
                    break;
                }
            }
        } // Loop up to next parent.
    }

    return hr;
}

Requisitos

Requisito Value
Plataforma de destino Windows
Encabezado mswmdm.h
Library Mssachlp.lib

Consulte también

Interfaz IWMDMStorage4