AccessibleObjectFromWindow 함수(oleacc.h)

지정된 창과 연결된 개체에 대해 지정된 인터페이스의 주소를 검색합니다.

구문

HRESULT AccessibleObjectFromWindow(
  [in]  HWND   hwnd,
  [in]  DWORD  dwId,
  [in]  REFIID riid,
  [out] void   **ppvObject
);

매개 변수

[in] hwnd

형식: HWND

개체를 검색할 창의 핸들을 지정합니다. 커서 또는 caret 개체에 대한 인터페이스 포인터를 검색하려면 NULL 을 지정하고 dwObjectID에서 적절한 개체 ID를 사용합니다.

[in] dwId

형식: DWORD

개체 ID를 지정합니다. 이 값은 표준 개체 식별자 상수 또는 office 네이티브 개체 모델의 개체 ID인 OBJID_NATIVEOM 같은 사용자 지정 개체 ID 중 하나입니다. OBJID_NATIVEOM 대한 자세한 내용은 이 항목의 설명 섹션을 참조하세요.

[in] riid

형식: REFIID

요청된 인터페이스의 참조 식별자를 지정합니다. 이 값은 IID_IAccessible 또는 IID_IDispatch 있지만 IID_IUnknown 또는 개체가 지원해야 하는 인터페이스의 IID일 수도 있습니다.

[out] ppvObject

형식: void**

지정된 인터페이스의 주소를 수신하는 포인터 변수의 주소입니다.

반환 값

형식: STDAPI

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

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

반환 코드	설명
E_INVALIDARG	인수가 잘못된 경우.
E_NOINTERFACE	요청한 인터페이스가 지원되지 않습니다.

설명

클라이언트는 이 함수를 호출하여 개체의 IAccessible, IDispatch, IEnumVARIANT, IUnknown 또는 기타 지원되는 인터페이스 포인터의 주소를 검색합니다.

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

클라이언트는 이 함수를 사용하여 Microsoft Office 2000 네이티브 개체 모델에 대한 액세스 권한을 얻습니다. 네이티브 개체 모델은 Microsoft Active Accessibility에서 노출되지 않는 Office 응용 프로그램의 문서 또는 클라이언트 영역에 대한 접근성 정보를 클라이언트에 제공합니다.

네이티브 개체 모델에서 지원하는 클래스에 대한 IDispatch 인터페이스 포인터를 가져오려면 dwObjectID에서 OBJID_NATIVEOM 지정합니다. 이 개체 식별자를 사용하는 경우 hwnd 매개 변수는 다음 창 클래스 형식과 일치해야 합니다.

Office 애플리케이션	Window 클래스	에 대한 IDispatch 포인터
Word	_WwG	시간 범위
Excel	EXCEL7	시간 범위
PowerPoint	paneClassDC	DocumentWindow
명령 모음	MsoCommandBar	CommandBar

 

위의 창 클래스는 가장 안쪽 문서 창 또는 창 창에 해당합니다. Office 개체 모델에 대한 자세한 내용은 Microsoft Office 2000/Visual Basic 프로그래머 가이드를 참조하세요.

요구 사항

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

추가 정보

AccessibleObjectFromEvent

AccessibleObjectFromPoint

IAccessible

IDispatch