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

Article
02/29/2024

La méthode GetParent récupère le parent du stockage.

Syntaxe

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

Paramètres

[out] ppStorage

Pointeur vers l’interface IWMDMStorage du stockage parent. L’appelant doit libérer cette interface lorsqu’il a terminé.

Valeur retournée

Cette méthode retourne un code HRESULT. Toutes les méthodes d’interface dans Windows Media Gestionnaire de périphériques peuvent retourner l’une des classes de codes d’erreur suivantes :

Codes d’erreur COM standard
Codes d’erreur Windows convertis en valeurs HRESULT
Codes d’erreur Gestionnaire de périphériques Windows Media

Pour obtenir une liste complète des codes d’erreur possibles, consultez Codes d’erreur.

Remarques

L’application peut parcourir la hiérarchie de stockage en appelant GetParent de manière récursive. Une fois le stockage racine atteint, GetParent retourne S_FALSE et définit ppStorage sur NULL.

Exemples

La fonction C++ suivante traverse jusqu’au parent racine d’un stockage.


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

Configuration requise

Condition requise	Valeur
Plateforme cible	Windows
En-tête	mswmdm.h
Bibliothèque	Mssachlp.lib

Voir aussi

IWMDMStorage4 Interface

Partager via