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 |
|---|---|
|
메서드가 성공했습니다. |
|
필요한 인수 중 하나 이상이 NULL 포인터였습니다. |
설명
일부 개체는 다른 개체에 대한 포인터 컬렉션인 폴더와 같은 속성의 컬렉션일 뿐이며, 다른 개체는 모든 속성과 실제 음악 비트를 포함하는 오디오 파일과 같은 속성과 데이터입니다. 이 메서드는 속성만 포함하는 개체를 만드는 데 사용됩니다. 속성과 데이터를 모두 사용하여 개체를 만들려면 CreateObjectWithPropertiesAndData를 사용합니다.
이 메서드는 동기적입니다. 반환될 때 새 개체가 디바이스에 있어야 합니다.
드라이버가 실제로 만드는 개체는 드라이버에 가장 편리한 개체 유형에 따라 속성 및 데이터 개체일 수 있습니다. 드라이버에서 만든 개체의 종류를 검사 새 개체의 WPD_OBJECT_FORMAT 속성을 요청합니다.
개체는 이 메서드가 반환될 때 디바이스에 만들어집니다.
예제
이 메서드를 사용하는 방법에 대한 예제는 Properties-Only 개체를 디바이스로 전송을 참조하세요.
요구 사항
| 요구 사항 | 값 |
|---|---|
| 대상 플랫폼 | Windows |
| 헤더 | portabledeviceapi.h |
| 라이브러리 | PortableDeviceGUIDs.lib |