ACAPI_Notify_GetParentElement

알림을 받은 실제 요소의 부모를 리턴합니다.

    GSErrCode  ACAPI_Notify_GetParentElement (
        API_Element*         element,
        API_ElementMemo*     memo,
        UInt32               mask
    );

 

파라미터

element

[out] 수신하게 될 부모 요소입니다.

memo

[out] 부모 요소의 추가 데이터입니다.

mask

[in] 수신하게 될 관련 메모 핸들들을 지정하기 위한 마스크입니다.

 

리턴 값

NoError

함수가 오류 없이 실행되었습니다.

APIERR_REFUSEDCMD

액션을 하는 동안 부모 요소가 없습니다.

다른 공통 API 오류들에 대해서는 API 오류 문서를 보십시오.

 

설명

이 함수는 알림을 받은 요소를 파생시킨 원래 요소 데이터를 가져오는 데 사용합니다. 만약 memo 파라미터에 NULL 값을 전달하면, 이 함수는 ACAPI_Element_Get 동작을 수행합니다. 그 외에는 ACAPI_Element_GetMemo 함수처럼 행동하게 됩니다.

이 함수를 이용하면 동작을 하는 동안 원래 요소에 발생한 변경사항들이 무엇인지 알아낼 수 있습니다.

 

예제

ACAPI_Notify_CatchNewElement에 대한 예제를 보십시오.

 

요구사항

버전: API 2.1 또는 이후

헤더: ACAPinc.h

 

참고사항

API_Element
API_ElementMemo
ACAPI_Notify_CatchNewElement
API_NotifyElementType
알림 관리자
API 함수