IWMDMStorage4::GetParent-Methode (mswmdm.h)

Artikel
03/04/2024

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

Freigeben über