IWMDMStorage4::GetReferences メソッド (mswmdm.h)

[アーティクル]
08/25/2023

GetReferences メソッドは、このストレージが指す IWMDMStorage オブジェクトへのポインターの配列を取得します。抽象アルバムまたはプレイリストは、通常、MTP デバイス上の参照のコレクションとして格納されます。

構文

HRESULT GetReferences(
  [out] DWORD        *pdwRefs,
  [out] IWMDMStorage ***pppIWMDMStorage
);

パラメーター

[out] pdwRefs

pppIWMDMStorage によって取得された値の数へのポインター。オブジェクトに参照がない場合、これは 0 を返し、関数はS_OKを返します。

[out] pppIWMDMStorage

ストレージ内の参照を表す IWMDMStorage インターフェイスポインターの配列へのポインターへのポインター。このような参照は、たとえば、プレイリストまたはアルバム内の項目を表すことができます。取得された配列は、オブジェクト自体に表示される順序と同じです。この配列のメモリは、Windows Media デバイスマネージャーによって割り当てられます。呼び出し元のアプリケーションがこの配列へのアクセスを完了したら、まずすべてのインターフェイスポインターで Release を 呼び出してから、 CoTaskMemFree を使用して配列メモリを解放する必要があります。

戻り値

このメソッドは HRESULT を返します。 Windows Media デバイスマネージャーのすべてのインターフェイスメソッドは、次のいずれかのエラーコードクラスを返すことができます。

標準 COM エラーコード
HRESULT 値に変換された Windows エラーコード
Windows Media デバイスマネージャーエラーコード

考えられるエラーコードの詳細な一覧については、「エラーコード」を参照してください。

注釈

Windows Media デバイスマネージャーは、ストレージ上の参照を追加および削除するタスクを基になるサービスプロバイダーに委任します。参照を持つオブジェクトは、抽象プレイリストやアルバムなどの抽象オブジェクトを指します。フォルダーは参照があるとは見なされません。

このメソッドでは、2 種類の非同期削除が発生し、エラーが発生する可能性があります。アプリケーションがストレージを取得してからストレージへの参照が削除され、アプリケーションが参照を使用しようとすると、メソッド呼び出しはWMDM_E_INTERFACEDEADを返します。参照先のファイルが削除されている場合は、S_FALSEが返されます。

例

次の C++ コードは、ストレージ (pStorage) の参照を照会します。


// Get references.
CComQIPtr<IWMDMStorage4> pStorage4(pStorage);
if (pStorage4 != NULL)
{
    WCHAR name[100];
    DWORD numRefs = 0;
    IWMDMStorage** parrReferences;
    hr = pStorage4->GetReferences(&numRefs, &parrReferences);
    for(int i = 0; i < numRefs; i++)
    {
        ZeroMemory(name, sizeof(name));
        hr = parrReferences[i]->GetName(name, (sizeof(name) / sizeof(WCHAR)) - 1);
        if (hr == S_OK)
            // TODO: Display the name.
        parrReferences[i]->Release();
    }
    // Free the memory.
    if (parrReferences != NULL)
        CoTaskMemFree(parrReferences);
}