IAccPropServices::ComposeHwndIdentityString 메서드(oleacc.h)

호출자는 ComposeHwndIdentityString을 사용하여 ID 문자열을 검색합니다.

구문

HRESULT ComposeHwndIdentityString(
  [in]  HWND  hwnd,
  [in]  DWORD idObject,
  [in]  DWORD idChild,
  [out] BYTE  **ppIDString,
  [out] DWORD *pdwIDStringLen
);

매개 변수

[in] hwnd

형식: HWND

호출자가 식별하려는 액세스 가능한 요소의 HWND 를 지정합니다.

[in] idObject

형식: DWORD

액세스 가능 요소의 개체 ID를 지정합니다.

[in] idChild

형식: DWORD

액세스 가능 요소의 자식 ID를 지정합니다.

[out] ppIDString

형식: BYTE**

ID 문자열을 받는 버퍼에 대한 포인터입니다. 호출 수신자는 CoTaskMemAlloc를 사용하여 이 버퍼를 할당합니다. 완료되면 호출자는 CoTaskMemFree를 호출하여 버퍼를 해제해야 합니다.

[out] pdwIDStringLen

형식: DWORD*

ID 문자열의 길이를 받는 버퍼에 대한 포인터입니다.

반환 값

형식: HRESULT

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

hwnd, idObject 또는 idChild가 유효하지 않으면 E_INVALIDARG 반환합니다.

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

요구 사항

요구 사항	값
지원되는 최소 클라이언트	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