FreeData

애드온의 종료 포인트입니다.

    GSErrCode  FreeData (
        void
    );

 

리턴 값

NoError

함수가 성공적으로 완료되었습니다.

 

설명

이 함수를 코드의 종료 포인트로 사용할 수 있습니다. DLL/코드 fragment가 메모리에서 언로드 되기 직전에 호출됩니다.

이 곳은 동적 메모리 블록을 해제하고 로드된 모듈을 언로드할 수 있는 곳입니다.

이 함수는 Initialize 함수와 함께 호출됩니다. Initialize 또는 다른 콜백 함수들에서 반환된 오류 코드가 있더라도 이 함수가 이전에 호출된 경우에만 FreeData 함수가 호출될 것이라고 확신할 수 있습니다.

  당신의 애드온이 사용자 인터페이스를 갖고 있고 컨텍스트에 민감한 도움말 엔진을 사용하고 싶다면(툴팁뿐만 아니라 도움말 앵커도 사용하길 원한다면), Initialize 함수에서 애드온의 MDID로 자신의 도움말 엔진 경로를 등록한 후 이 데이터를 초기화하지 마십시오.

  일부 예외적인 경우 애플리케이션은 애드온들의 FreeData 함수를 호출하지 않고 종료됩니다. 이러한 상황에서 시스템은 애드온 모듈들을 언로드합니다. 이러한 비정상적인 종료 사례를 처리하기 위해 호출해야 할 경우 ACAPI_SetDllTermHookProc 함수를 사용하여 APIDllTermHookProc를 설정하십시오.

 

예제

GSErrCode  __ACENV_CALL   FreeData (void)
 
{
    BMhFree ((GSHandle) handle);

    // 만약 당신이 Initialize 함수에서 RegisterAdditionalHelpLocation을 사용했다면,
    DG::UnregisterAdditionalHelpLocation (MDID_APICD, MDID_APICD_InterfaceFunctions);

    return NoError;
}

 

요구사항

버전: API 1.3 또는 이후

헤더: ACAPinc.h

 

참고사항

필수 함수, Initialize
ACAPI_SetDllTermHookProc, APIDllTermHookProc
DGUnregisterAdditionalHelpLocation
API 함수