IAccessibleWindowlessSite::AcquireObjectIdRange 메서드(oleacc.h)

컨트롤 호스트에서 개체 ID의 범위를 획득하고 특정 창 없는 컨트롤에 의해 예약된 것으로 표시합니다.

구문

HRESULT AcquireObjectIdRange(
  [in]           long               rangeSize,
  [in, optional] IAccessibleHandler *pRangeOwner,
  [out]          long               *pRangeBase
);

매개 변수

[in] rangeSize

요청되는 개체 ID 범위의 크기입니다.

[in, optional] pRangeOwner

범위를 요청하는 창 없는 컨트롤입니다.

[out] pRangeBase

획득한 범위의 첫 번째 개체 ID입니다.

반환 값

메서드가 성공하면 S_OK를 반환하고, 그러지 않으면 HRESULT 오류 코드를 반환합니다.

설명

다른 창 없는 컨트롤에 속하는 개체 ID를 사용하지 않도록 하려면 NotifyWinEvent 함수를 호출하기 전에 컨트롤이 개체 ID 범위를 획득해야 합니다. 컨트롤은 포함된 모든 액세스 가능한 개체에 대해 충분한 개체 ID를 획득해야 합니다. 예를 들어 자식이 100개인 트리 컨트롤은 101개 이상의 개체 ID를 예약하고, 하나는 루트에, 다른 하나는 자식에 대해 예약합니다. 증가할 것으로 예상되는 트리 컨트롤은 예상대로 많은 개체 ID를 예약합니다. 트리 컨트롤이 수백 명의 자식으로 증가할 것으로 예상되는 경우 안전을 위해 1,000개의 ID 범위를 예약합니다.

Microsoft ActiveX 컨트롤이 포함된 창에서 예약된 범위에 있는 LPARAM 값(개체 ID)이 있는 WM_GETOBJECT 메시지를 받으면 IAccessibleHandler::AccessibleObjectFromID 메서드를 호출하여 해당 개체 ID에 대한 IAccessible 개체를 가져와야 합니다.

요구 사항

요구 사항	값
지원되는 최소 클라이언트	Windows 8 [데스크톱 앱만 해당]
지원되는 최소 서버	Windows Server 2012 [데스크톱 앱만 해당]
대상 플랫폼	Windows
헤더	oleacc.h
라이브러리	Oleacc.lib
DLL	Oleacc.dll

추가 정보

IAccessibleWindowlessSite

IAccessibleWindowlessSite::ReleaseObjectIdRange