CWiauPropertyList::D efineProperty 메서드(wiautil.h)

CWiauPropertyList::D efineProperty 메서드는 속성 목록 개체에 속성 정의를 추가합니다.

구문

HRESULT DefineProperty(
  int      *pIdx,
  PROPID   PropId,
  LPOLESTR PropName,
  ULONG    Access,
  ULONG    SubType
);

매개 변수

pIdx

새로 추가된 속성의 인덱스를 받는 메모리 위치에 대한 포인터입니다. 이 클래스의 다른 많은 메서드는 속성을 식별하기 위해 속성의 인덱스 를 사용합니다.

PropId

속성 ID 상수를 지정합니다.

PropName

속성의 이름 문자열에 대한 포인터입니다.

Access

속성에 대한 액세스 유형(일반적으로 WIA_PROP_READ(읽기 전용) 또는 WIA_PROP_RW(읽기/쓰기))을 지정합니다.

SubType

WIA_PROP_FLAG, WIA_PROP_LIST, WIA_PROP_RANGE 또는 WIA_PROP_NONE 중 하나인 속성 하위 형식을 지정합니다. 처음 세 개의 상수는 각각 속성이 플래그 값 집합, 값 목록 또는 값 범위임을 나타냅니다. 네 번째 상수는 속성이 이러한 항목이 없음을 나타냅니다.

반환 값

이 메서드는 속성을 성공적으로 정의할 수 있으면 S_OK 반환합니다. 속성 목록에 추가 속성에 대한 충분한 공간이 없는 경우 메서드는 E_FAIL 반환합니다.

설명

속성을 속성 목록에 추가하려면 먼저 속성 목록을 초기화해야 합니다. CWiauPropertyList::Init 메서드를 호출하여 이 작업을 수행합니다.

요구 사항

추가 정보

CWiauPropertyList

CWiauPropertyList::Init