IPortableDeviceContent::GetObjectIDsFromPersistentUniqueIDs メソッド (portabledeviceapi.h)

  • [アーティクル]

GetObjectIDsFromPersistentUniqueIDs メソッドは、永続的な一意 ID (PUID) を指定して、1 つ以上のオブジェクトの現在のオブジェクト ID を取得します。

構文

HRESULT GetObjectIDsFromPersistentUniqueIDs(
  [in]  IPortableDevicePropVariantCollection *pPersistentUniqueIDs,
  [out] IPortableDevicePropVariantCollection **ppObjectIDs
);

パラメーター

[in] pPersistentUniqueIDs

1 つ以上の永続的な一意 ID (PUID) 文字列値 (型VT_LPWSTR) を含む IPortableDevicePropVariantCollection インターフェイスへのポインター。

[out] ppObjectIDs

型VT_LPWSTRとして、取得したオブジェクト ID を含む IPortableDevicePropVariantCollection インターフェイス ポインターへのポインター。 取得された ID は、送信された PUID と同じ順序になります。値が見つからなかった場合は、空の文字列で示されます。 呼び出し元は、このインターフェイスの使用が完了したら、このインターフェイスを解放する必要があります。

戻り値

このメソッドは HRESULT を返します。 有効な値を次の表に示しますが、これ以外にもあります。

リターン コード 説明
S_OK
 メソッドが成功しました。
E_POINTER
 必要な引数の少なくとも 1 つが NULL ポインターでした。

注釈

Windows ポータブル デバイス オブジェクト ID はデバイス全体で一意ですが、セッション間で異なる場合があります。 オブジェクト ID は、アプリケーションがデバイスに再接続するときに変更される可能性があります。

同期エンジンなどの特定のアプリケーションでは、接続セッション間でオブジェクトを識別する方法が必要です。 すべてのオブジェクトには、セッション間で永続的な識別子を示す WPD_OBJECT_PERSISTENT_UNIQUE_ID プロパティがあります。 アプリケーションは、 Properties メソッドを呼び出すことで、最初のセッションでこのプロパティを読み取って保存できます。

例

このメソッドの使用方法の例については、「永続的な一意識別子からオブジェクト識別子を取得する」を参照してください。

要件

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

こちらもご覧ください

IPortableDeviceContent インターフェイス

永続的な一意識別子からのオブジェクト識別子の取得