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

  • 아티클

CreateObjectWithPropertiesOnly 메서드는 디바이스에 속성만 있는 개체를 만듭니다.

구문

HRESULT CreateObjectWithPropertiesOnly(
            IPortableDeviceValues *pValues,
  [in, out] LPWSTR                *ppszObjectID
);

매개 변수

pValues

개체에 할당할 속성의 IPortableDeviceValues 컬렉션입니다. 개체에 대한 필수 및 선택적 속성 목록은 개체에 대한 요구 사항을 참조하세요.

[in, out] ppszObjectID

새 개체의 이름을 받을 선택적 문자열 포인터입니다. 필요하지 않은 경우 NULL일 수 있습니다. Windows 이식 가능한 디바이스는 디바이스를 나타내는 상수 WPD_DEVICE_OBJECT_ID 정의합니다. SDK는 이 메모리를 할당합니다. 호출자는 CoTaskMemFree를 사용하여 해제해야 합니다.

반환 값

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

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

설명

일부 개체는 다른 개체에 대한 포인터 컬렉션인 폴더와 같은 속성의 컬렉션일 뿐이며, 다른 개체는 모든 속성과 실제 음악 비트를 포함하는 오디오 파일과 같은 속성과 데이터입니다. 이 메서드는 속성만 포함하는 개체를 만드는 데 사용됩니다. 속성과 데이터를 모두 사용하여 개체를 만들려면 CreateObjectWithPropertiesAndData를 사용합니다.

이 메서드는 동기적입니다. 반환될 때 새 개체가 디바이스에 있어야 합니다.

드라이버가 실제로 만드는 개체는 드라이버에 가장 편리한 개체 유형에 따라 속성 및 데이터 개체일 수 있습니다. 드라이버에서 만든 개체의 종류를 검사 새 개체의 WPD_OBJECT_FORMAT 속성을 요청합니다.

개체는 이 메서드가 반환될 때 디바이스에 만들어집니다.

예제

이 메서드를 사용하는 방법에 대한 예제는 Properties-Only 개체를 디바이스로 전송을 참조하세요.

요구 사항

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

추가 정보

IPortableDeviceContent 인터페이스

Properties-Only 개체를 디바이스로 전송