次の方法で共有

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

  • [アーティクル]

GetReferences メソッドは、プレイリストまたはアルバム オブジェクトを表す参照など、関連付けストレージに含まれる参照を構成する IMDSPStorage オブジェクトへのポインターの配列を返します。

構文

HRESULT GetReferences(
  [out] DWORD        *pdwRefs,
  [out] IMDSPStorage ***pppISPStorage
);

パラメーター

[out] pdwRefs

pppIWMDMStorage で返される IWMDMStorage インターフェイス ポインターの数へのポインター。

[out] pppISPStorage

ストレージ上の参照を表す IWMDMStorage インターフェイス ポインターの配列へのポインターへのポインター。 このような参照は、たとえば、プレイリストまたはアルバム内の項目を表すことができます。 参照の順序は、この配列の順序と一致します。 この配列のメモリは、サービス プロバイダーによって割り当てる必要があります。

戻り値

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

  • 標準 COM エラー コード
  • HRESULT 値に変換された Windows エラー コード
  • Windows Media デバイス マネージャー エラー コード
考えられるエラー コードの詳細な一覧については、「 エラー コード」を参照してください。

注釈

Windows Media デバイス マネージャーでは、このメソッドを使用して、プレイリストやアルバムなどの関連付けストレージ上の参照を取得します。

ストレージに、デバイスから削除された 1 つ以上の項目への参照がある場合、SP は返される参照にこれらの参照を含めないようにする必要があります。 SP は、S_FALSEを返すことによって、このような状態を示す必要があります。 アプリケーションは、ここで返される既知の適切な参照を使用して、関連付けストレージ オブジェクトを更新することを選択できます。 SP は、参照自体を更新することもできます。

参照の数が 0 の場合、サービス プロバイダーは 0 個の要素を含む参照の配列を返す必要があります。

要件

要件 値
対象プラットフォーム Windows
ヘッダー mswmdm.h
Library Mssachlp.lib

こちらもご覧ください

IMDSPStorage4 インターフェイス

IMDSPStorage4::SetReferences