MI_Operation_GetInstance 함수(mi.h)

instance 작업에 대한 동기 결과를 가져옵니다.

구문

MI_INLINE MI_Result MI_Operation_GetInstance(
  [in]            MI_Operation      *operation,
                  const MI_Instance **instance,
  [out, optional] MI_Boolean        *moreResults,
  [out, optional] MI_Result         *result,
                  const MI_Char     **errorMessage,
                  const MI_Instance **completionDetails
);

매개 변수

[in] operation

instance 세션 작업에서 반환된 작업 핸들입니다.

instance

반환된 instance. 작업이 성공하더라도 이 값은 Null 일 수 있습니다. 반환된 instance MI_Operation_GetInstance 또는MI_Operation_Close 다음 호출까지 유효합니다. 이러한 호출에서 instance 활성 상태를 유지해야 하는 경우 MI_Instance_Clone 통해 클래스를 복제해야 합니다.

[out, optional] moreResults

더 많은 결과를 사용할 수 있는지 여부를 나타내는 부울 값이 반환되었습니다. MI_TRUE 값은 더 많은 결과를 검색할 수 있음을 의미합니다. moreResults 값이 MI_FALSE 때까지 이 함수를 호출해야 합니다(MI_Operation_Cancel 통해 작업이 취소된 경우에도). moreResults가 MI_FALSE 설정된 마지막 결과를 검색하기 전에 MI_Operation_Close 호출하면 MI_Operation_Close 함수의 응답이 중지됩니다.

[out, optional] result

함수 호출의 성공 또는 실패를 나타내는 반환된 값입니다. MI_RESULT_OK 값은 성공을 나타냅니다. 그렇지 않으면 반환된 errorMessage 값을 사용하여 오류의 원인을 확인해야 합니다.

errorMessage

오류의 경우 이 반환된 값은 오류의 원인에 대한 추가 디버깅 정보를 제공합니다. 이 오류 메시지의 수명은 classResult 값과 동일합니다.

completionDetails

오류의 경우 이 반환된 값은 일반적으로 CIM_Error 개체(또는 파생 클래스) 형식의 추가 오류 정보를 제공합니다. 반환된 instance classResult 값과 수명이 동일합니다. 이 값을 더 오래 활성 상태로 유지해야 하는 경우 MI_Instance_Clone 통해 값을 복제해야 합니다.

반환 값

없음

설명

이 함수는 MI_Operation_GetIndication 사용해야 하는 구독을 제외한 모든 instance 작업에 대한 모든 동기 결과를 가져오기 위해 호출됩니다. 이 함수는 결과를 사용할 수 있을 때까지 차단됩니다. moreResults 매개 변수가 MI_FALSE 값으로 반환될 때까지 호출해야 합니다. instance 콜백이 등록된 경우 이 함수를 호출하는 것은 오류입니다.

요구 사항