IWMDMStorage4::GetParent-Methode (mswmdm.h)

  • Artikel

Die GetParent-Methode ruft das übergeordnete Element des Speichers ab.

Syntax

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

Parameter

[out] ppStorage

Zeiger auf die IWMDMStorage-Schnittstelle des übergeordneten Speichers. Der Aufrufer muss diese Schnittstelle freigeben, wenn er damit fertig ist.

Rückgabewert

Die Methode gibt ein HRESULT zurück. Alle Schnittstellenmethoden in Windows Media Geräte-Manager können eine der folgenden Klassen von Fehlercodes zurückgeben:

  • Com-Standardfehlercodes
  • In HRESULT-Werte konvertierte Windows-Fehlercodes
  • Windows Media Geräte-Manager Fehlercodes
Eine ausführliche Liste möglicher Fehlercodes finden Sie unter Fehlercodes.

Hinweise

Die Anwendung kann in der Speicherhierarchie navigieren, indem GetParent rekursiv aufgerufen wird. Nachdem der Stammspeicher erreicht wurde, gibt GetParent S_FALSE zurück und legt ppStorage auf NULL fest.

Beispiele

Die folgende C++-Funktion geht bis zum übergeordneten Stammelement eines Speichers.


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

Anforderungen

Anforderung Wert
Zielplattform Windows
Kopfzeile mswmdm.h
Bibliothek Mssachlp.lib

Weitere Informationen

IWMDMStorage4-Schnittstelle