IPortableDeviceProperties::GetPropertyAttributes 메서드(portabledeviceapi.h)

  • 아티클

GetPropertyAttributes 메서드는 디바이스에서 지정된 개체 속성의 특성을 검색합니다.

구문

HRESULT GetPropertyAttributes(
  [in]  LPCWSTR               pszObjectID,
  [in]  REFPROPERTYKEY        Key,
  [out] IPortableDeviceValues **ppAttributes
);

매개 변수

[in] pszObjectID

쿼리할 개체의 개체 ID를 포함하는 null로 끝나는 문자열에 대한 포인터입니다. 디바이스를 지정하려면 WPD_DEVICE_OBJECT_ID 사용합니다.

[in] Key

쿼리할 속성을 지정하는 REFPROPERTYKEY 입니다. GetSupportedProperties를 호출하여 지원되는 속성 목록을 검색할 수 있습니다. Windows 이식 가능한 디바이스에서 정의한 속성 목록은 속성 및 특성을 참조하세요.

[out] ppAttributes

검색된 속성 특성을 보유하는 IPortableDeviceValues 인터페이스에 대한 포인터를 수신하는 변수의 주소입니다. PROPERTYKEY/값 쌍입니다. 여기서 PROPERTYKEY 는 속성이고 값 데이터 형식은 특정 속성에 따라 달라집니다. 호출자는 이 인터페이스가 완료되면 이 인터페이스를 해제해야 합니다. Windows 이식 가능 디바이스에서 정의한 특성은 속성 및 특성 페이지에서 찾을 수 있습니다.

반환 값

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

반환 코드 Description
S_OK
 메서드가 성공했고 모든 특성이 성공적으로 검색되었습니다.
S_FALSE
 일부 특성 값만 검색할 수 있습니다. 다른 사용자는 VT_ERROR 형식의 HRESULT 값을 포함할 수 없습니다.
E_POINTER
 필수 포인터 인수는 NULL입니다.

설명

속성 특성은 속성의 액세스 권한, 유효한 값 및 기타 정보를 설명합니다. 예를 들어 속성은 삭제를 방지하기 위해 WPD_PROPERTY_ATTRIBUTE_CAN_DELETE 값을 False로 설정하고 유효한 값의 범위를 개별 항목으로 저장할 수 있습니다.

예제

이 메서드를 사용하는 방법에 대한 예제는 단일 개체에 대한 속성 설정을 참조하세요.

요구 사항

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

추가 정보

IPortableDeviceProperties 인터페이스

단일 개체에 대한 속성 설정

Content-Object 속성 작성