MI_Application_InitializeV1 함수(mi.h)

MI(관리 인프라) 클라이언트 API 호출을 수행할 수 있도록 애플리케이션을 초기화합니다.

구문

MI_Result MI_MAIN_CALL MI_Application_InitializeV1(
                  MI_Uint32      flags,
  [in, optional]  const MI_Char  *applicationID,
  [out, optional] MI_Instance    **extendedError,
  [out]           MI_Application *application
);

매개 변수

flags

0이어야 합니다.

[in, optional] applicationID

클라이언트 애플리케이션을 나타내는 선택적 문자열(일반적으로 문자열 형식의 GUID )입니다. 이 문자열은 애플리케이션별 구성 및 애플리케이션별 로깅에 사용할 수 있습니다.

[out, optional] extendedError

작업이 실패한 경우 추가 오류 정보를 제공하는 선택적 매개 변수입니다. instance 반환되는 경우 더 이상 필요하지 않은 경우 MI_Instance_Delete 호출하여 해제해야 합니다.

[out] application

초기화되지 않은 MI_Application 핸들에 대한 포인터가 전달되고 채워진 핸들이 반환됩니다. 애플리케이션이 종료되기 전에 초기화된 핸들을 MI_Application_Close 전달해야 합니다. 애플리케이션이 이 핸들을 전달하는 경우 포인터가 아닌 값으로 전달합니다.

반환 값

이 함수는 MI_Result MI_MAIN_CALL 반환합니다.

설명

이 API는 애플리케이션당 한 번만 호출해야 합니다. 하지만 안전하게 여러 번 호출할 수 있습니다. 이 API를 여러 번 호출하면 약간의 추가 메모리 사용량이 발생합니다. 호출되면 애플리케이션이 초기화할 MI_Application 포인터를 전달합니다. 이 포인터는 MI_Application_Close 호출하여 닫아야 합니다. 이렇게 하지 않으면 종료 중에 메모리 누수 및 잠재적인 충돌이 발생합니다.

MI.h는 MI_Application_Initialize 다음 줄을 사용하여 MI_Application_InitializeV1 정의합니다.

#define MI_Application_Initialize MI_Application_InitializeV1

요구 사항