IAccPropServer::GetPropValue 메서드(oleacc.h)

액세스 가능한 요소에 대한 속성 값을 검색합니다.

구문

HRESULT GetPropValue(
  [in]  const BYTE *pIDString,
  [in]  DWORD      dwIDStringLen,
  [in]  MSAAPROPID idProp,
  [out] VARIANT    *pvarValue,
  [out] BOOL       *pfHasProp
);

매개 변수

[in] pIDString

형식: const BYTE*

요청되는 속성을 식별하는 문자열을 포함합니다.

[in] dwIDStringLen

형식: DWORD

pIDString 매개 변수로 지정되는 ID 문자열의 길이를 지정합니다.

[in] idProp

형식: MSAAPROPID

원하는 속성을 나타내는 GUID를 지정합니다.

[out] pvarValue

형식: VARIANT*

재정의된 속성 값을 지정합니다. 이 매개 변수는 pfHasProp이TRUE인 경우에만 유효합니다. pfHasProp이 FALSE로 설정된 경우 서버는 이를 VT_EMPTY 설정해야 합니다.

[out] pfHasProp

형식: BOOL*

서버가 요청된 속성의 값을 제공하는지 여부를 나타냅니다. 서버는 재정의 속성을 반환하는 경우 TRUE 로 설정하거나 속성을 반환하지 않는 경우 FALSE 로 설정해야 합니다(이 경우 pvarValue 도 VT_EMPTY 설정해야 함).

반환 값

형식: HRESULT

메모리 부족과 같은 예외적인 오류 조건을 제외하고 S_OK 반환합니다. 지정된 속성을 재정의하지 않으면 pfHasProp 을 FALSE 로 설정하고 pvarValue 를 서버에서 VT_EMPTY 설정해야 합니다.

설명

액세스 가능한 여러 요소에 주석을 추가하기 위해 단일 콜백 개체가 등록된 경우 ID 문자열을 사용하여 이 요청이 참조하는 요소를 확인할 수 있습니다.

액세스 가능한 요소가 HWND 기반인 경우 IAccPropServices::D ecomposeHwndIdentityString을 사용하여 ID 문자열에서 HWND/idObject/idChild를 추출할 수 있습니다.

콜백에 지정된 속성에 대해 반환할 값이 있는 경우 pvarValue 에서 반환하고 pfHasProp 을 TRUE로 설정해야 합니다. 그렇지 않으면 pvarValue 를 VT_EMPTY 설정하고 pfHasProp을FALSE로 설정해야 합니다. 이 후자의 경우 원래 IAccessible 인터페이스 포인터를 사용하여 이 속성의 값을 가져옵니다.

요구 사항

요구 사항	값
지원되는 최소 클라이언트	Windows Vista 또는 Windows XP
지원되는 최소 서버	Windows Server 2003
대상 플랫폼	Windows
헤더	oleacc.h(OleAcc.h Include Initguid.h first 포함).
DLL	Oleacc.dll
재배포 가능 파일	SP6 이상 및 Windows 98을 Windows NT 4.0의 활성 접근성 2.0 RDK