Metodo IWMDMStorage4::GetParent (mswmdm.h)

Articolo
02/29/2024

Il metodo GetParent recupera l'elemento padre dell'archiviazione.

Sintassi

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

Parametri

[out] ppStorage

Puntatore all'interfaccia IWMDMStorage dell'archiviazione padre. Il chiamante deve rilasciare questa interfaccia al termine.

Valore restituito

Il metodo restituisce un HRESULT. Tutti i metodi di interfaccia in Windows Media Gestione dispositivi possono restituire una delle classi di codici di errore seguenti:

Codici di errore COM standard
Codici di errore di Windows convertiti in valori HRESULT
Codici di errore di Windows Media Gestione dispositivi

Per un elenco completo dei codici di errore possibili, vedere Codici di errore.

Commenti

L'applicazione può spostarsi fino alla gerarchia di archiviazione chiamando GetParent ricorsivamente. Dopo aver raggiunto l'archiviazione radice, GetParent restituisce S_FALSE e imposta ppStorage su NULL.

Esempio

La funzione C++ seguente attraversa fino all'elemento padre radice di un'archiviazione.


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

Requisiti

Requisito	Valore
Piattaforma di destinazione	Windows
Intestazione	mswmdm.h
Libreria	Mssachlp.lib

Vedi anche

Interfaccia IWMDMStorage4

Condividi tramite