IWMDMStorage4：：GetParent 方法 (mswmdm.h)

GetParent 方法會擷取記憶體的父代。

語法

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

參數

[out] ppStorage

父記憶體 IWMDMStorage 介面的指標。 呼叫端必須在完成時釋放此介面。

傳回值

方法會傳回 HRESULT。 Windows Media 裝置管理員 中的所有介面方法都可以傳回下列任何一種錯誤碼類別：

• 標準 COM 錯誤碼
• 轉換成 HRESULT 值的 Windows 錯誤碼
• Windows Media 裝置管理員 錯誤碼

備註

應用程式可以透過以遞歸方式呼叫 GetParent 來巡覽記憶體階層。 到達根記憶體之後， GetParent 會傳回S_FALSE，並將 ppStorage 設定為 NULL。

範例

下列 C++ 函式會周游至記憶體的根父系。

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

規格需求

另請參閱

IWMDMStorage4 介面