IPortableDeviceContent::GetObjectIDsFromPersistentUniqueIDs 메서드(portabledeviceapi.h)

GetObjectIDsFromPersistentUniqueIDs 메서드는 PUID(영구 고유 ID)가 지정된 경우 하나 이상의 개체의 현재 개체 ID를 검색합니다.

구문

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

매개 변수

[in] pPersistentUniqueIDs

하나 이상의 PUID(영구 고유 ID) 문자열 값(VT_LPWSTR 형식)이 포함된 IPortableDevicePropVariantCollection 인터페이스에 대한 포인터입니다.

[out] ppObjectIDs

검색된 개체 ID를 형식으로 포함하는 IPortableDevicePropVariantCollection 인터페이스 포인터에 대한 포인터 VT_LPWSTR. 검색된 ID는 제출된 PUID와 동일한 순서입니다. 값을 찾을 수 없으면 빈 문자열로 표시됩니다. 호출자는 이 인터페이스가 완료되면 이 인터페이스를 해제해야 합니다.

반환 값

이 메서드는 HRESULT를 반환합니다. 가능한 값에는 다음 표에 있는 값이 포함되지만, 이에 국한되는 것은 아닙니다.

반환 코드	Description
S_OK	메서드가 성공했습니다.
E_POINTER	필요한 인수 중 하나 이상이 NULL 포인터였습니다.

설명

Windows 이식 가능한 디바이스 개체 ID는 장치 전체에서 고유하지만 세션 간에 다를 수 있습니다. 애플리케이션이 디바이스에 다시 연결되면 개체 ID가 변경될 수 있습니다.

동기화 엔진과 같은 특정 애플리케이션에는 연결 세션 간에 개체를 식별하는 방법이 필요합니다. 모든 개체에는 세션 간에 지속되는 식별자를 나타내는 WPD_OBJECT_PERSISTENT_UNIQUE_ID 속성이 있습니다. 애플리케이션은 Properties 메서드를 호출하여 초기 세션에서 이 속성을 읽고 저장할 수 있습니다.

예제

이 메서드를 사용하는 방법에 대한 예제는 영구 고유 식별자에서 개체 식별자 검색을 참조하세요.

요구 사항

요구 사항	값
대상 플랫폼	Windows
헤더	portabledeviceapi.h
라이브러리	PortableDeviceGUIDs.lib

추가 정보

IPortableDeviceContent 인터페이스

영구 고유 식별자에서 개체 식별자 검색