IAccessibleHandler::AccessibleObjectFromID 메서드(oleacc.h)

AccessibleObjectFromID 메서드는 지정된 개체 ID와 연결된 인터페이스에 대한 IAccessible 인터페이스 포인터를 검색합니다. Oleacc.dll 이 메서드를 사용하여 다른 코드에서 제공하는 프록시에 대한 IAccessible 인터페이스 포인터를 가져옵니다.

참고IAccessibleHandler::AccessibleObjectFromID 는 더 이상 사용되지 않으며 사용하면 안 됩니다.

 

구문

HRESULT AccessibleObjectFromID(
  [in]  long         hwnd,
  [in]  long         lObjectID,
  [out] LPACCESSIBLE *pIAccessible
);

매개 변수

[in] hwnd

형식: long

IAccessible 인터페이스 포인터를 검색할 창의 핸들을 지정합니다.

[in] lObjectID

형식: long

개체 ID를 지정합니다. 이 값은 표준 개체 식별자 상수 또는 사용자 지정 개체 ID 중 하나입니다.

[out] pIAccessible

형식: LPACCESSIBLE*

개체의 IAccessible 인터페이스 주소를 수신하는 포인터 변수의 주소를 지정합니다.

반환 값

형식: HRESULT

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

성공하지 못하면 다음 또는 다른 표준 COM 오류 코드 중 하나를 반환합니다.

오류	Description
E_INVALIDARG	인수가 잘못된 경우.
E_NOINTERFACE	요청한 인터페이스가 지원되지 않습니다.

설명

Oleacc는 이 함수를 호출하여 이 처리기가 등록된 클래스 이름을 가진 HWND에 대한 IAccessible 인터페이스 포인터를 가져옵니다.

시작 시 Oleacc는 레지스트리 키 HKLM\SOFTWARE\Microsoft\Active Accessibility\Handlers를 살펴보고 각 하위 키에 대해 열거합니다(Oleacc는 하위 키가 GUID로 예상됨). Oleacc는 HKCR\CLSID{guid}\AccClassName에서 연결된 클래스 이름을 읽습니다. 여기서 {guid}는 HKLM\SOFTWARE\Microsoft\Active Accessibility\Handlers 키 아래에 있는 GUID입니다. Oleacc는 GUID와 일치하는 클래스 이름을 가진 창을 찾으면 GUID를 사용하여 개체를 공동 생성하고, IAccessibleHandler 인터페이스 포인터를 검색하고, IAccessible 인터페이스 포인터에서 AccessibleObjectFromID 를 호출하여 IAccessible 인터페이스 포인터를 가져옵니다.

다른 IAccessible 메서드 및 함수와 마찬가지로 클라이언트는 사용자 작업으로 인해 IAccessible 인터페이스 포인터에 대한 오류를 수신할 수 있습니다. 자세한 내용은 IAccessible 인터페이스 포인터에 대한 오류 수신을 참조하세요.

요구 사항

요구 사항	값
지원되는 최소 클라이언트	Windows 2000 Professional[데스크톱 앱만]
지원되는 최소 서버	Windows Server 2003 [데스크톱 앱만 해당]
대상 플랫폼	Windows
헤더	oleacc.h
라이브러리	Oleacc.lib
DLL	Oleacc.dll
재배포 가능 파일	SP6 이상 및 Windows 95를 Windows NT 4.0의 활성 접근성 1.3 RDK