IAccessible::get_accChild 메서드(oleacc.h)

아티클
02/29/2024

IAccessible::get_accChild 메서드는 지정된 자식에 대한 IDispatch(있는 경우)를 검색합니다. 모든 개체는 이 속성을 지원해야 합니다.

구문

HRESULT get_accChild(
  [in]          VARIANT   varChild,
  [out, retval] IDispatch **ppdispChild
);

매개 변수

[in] varChild

형식: VARIANT

IDispatch 인터페이스가 검색되는 자식 을 식별합니다. VARIANT를 초기화하는 방법에 대한 자세한 내용은 매개 변수에서 자식 ID를 사용하는 방법을 참조하세요.

[out, retval] ppdispChild

형식: IDispatch**

[out, retval] 자식 개체의 IDispatch 인터페이스 주소를 받습니다.

반환 값

형식: HRESULT

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

성공하지 못하면 다음 테이블의 값 중 하나 또는 다른 표준 COM 오류 코드를 반환합니다. 서버는 이러한 값을 반환하지만 클라이언트는 항상 출력 매개 변수를 검사 유효한 값을 포함해야 합니다. 자세한 내용은 IAccessible 반환 값 확인을 참조하세요.

오류	Description
S_FALSE	자식이 액세스 가능한 개체가 아닙니다.
E_INVALIDARG	인수가 잘못된 경우.

설명

서버는 요소를 요소(자식 ID) 또는 전체 개체(IAccessible 인터페이스 포인터)로 노출합니다. 자식이 요소인 경우 get_accChild S_FALSE 반환하고 부모는 해당 자식에 대한 정보를 제공합니다. 자식이 전체 개체인 경우 get_accChildIAccessible 인터페이스 포인터를 반환하고 부모는 해당 자식에 대한 정보를 제공하지 않습니다. 임시 시스템 오류(예: 메모리 부족 오류)로 인해 서버 애플리케이션에서 액세스 가능한 개체를 만들 수 없으므로 get_accChild 실패하는 경우 서버는 적절한 오류 코드를 반환해야 합니다.

서버 개발자에게 참고: varChildID에 VT_EMPTY 포함된 경우 E_INVALIDARG 반환해야 합니다.

서버 예제

다음 예제 코드는 자식이 없거나 자식이 개체가 아닌 요소인 개체에 대한 구현을 보여줍니다.


HRESULT STDMETHODCALLTYPE AccServer::get_accChild( 
    VARIANT varChild,
    IDispatch **ppdispChild)
{
    if (varChild.vt != VT_I4)
    {
        *ppdispChild = NULL;
        return E_INVALIDARG;
    }
    *ppdispChild = NULL;    
    return S_FALSE;     
};

요구 사항

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