IAccPropServices::D ecomposeHwndIdentityString 메서드(oleacc.h)

이 메서드를 사용하여 ID 문자열로 식별된 액세스 가능한 요소에 대한 HWND, 개체 ID 및 자식 ID를 확인합니다.

구문

HRESULT DecomposeHwndIdentityString(
  [in]  const BYTE *pIDString,
  [in]  DWORD      dwIDStringLen,
  [out] HWND       *phwnd,
  [out] DWORD      *pidObject,
  [out] DWORD      *pidChild
);

매개 변수

[in] pIDString

형식: const BYTE*

HWND 기반 액세스 가능한 요소의 ID 문자열을 포함하는 버퍼에 대한 포인터입니다.

[in] dwIDStringLen

형식: DWORD

pIDString으로 지정되는 ID 문자열의 길이를 지정합니다.

[out] phwnd

형식: HWND*

액세스 가능한 요소의 HWND 를 수신하는 버퍼에 대한 포인터입니다.

[out] pidObject

형식: DWORD*

액세스 가능 요소의 개체 ID를 받는 버퍼에 대한 포인터입니다.

[out] pidChild

형식: DWORD*

액세스 가능 요소의 자식 ID를 받는 버퍼에 대한 포인터입니다.

반환 값

형식: HRESULT

성공하면 S_OK를 반환합니다.

phwnd, pidObject 또는 pidChild가 유효하지 않거나 지정된 ID 문자열이 HWND 기반 ID 문자열이 아닌 경우 E_INVALIDARG 반환합니다.

메모리 부족과 같은 예외적인 오류 조건에서 다른 오류 코드를 반환할 수 있습니다.

설명

이 메서드는 제공된 ID 문자열이 HWND 기반 ID 문자열인 경우에만 성공합니다. 이 메서드는 서버가 지정된 ID 문자열에서 클라이언트가 서버를 호출하는 자식 요소(idChild)를 확인할 수 있으므로 ANNO_CONTAINER scope 등록된 IAccPropServer 콜백 서버에서 사용할 때 유용합니다.

요구 사항

요구 사항	값
지원되는 최소 클라이언트	Windows XP [데스크톱 앱만 해당]
지원되는 최소 서버	Windows Server 2003 [데스크톱 앱만 해당]
대상 플랫폼	Windows
헤더	oleacc.h(먼저 OleAcc.h 포함 Initguid.h 포함).
DLL	Oleacc.dll
재배포 가능 파일	SP6 이상 및 Windows 98을 Windows NT 4.0의 활성 접근성 2.0 RDK