MI_Session_ReferenceInstances 함수(mi.h)

지정된 키 instance 참조하는 연결 개체를 찾습니다.

구문

MI_INLINE void MI_Session_ReferenceInstances(
  [in]           MI_Session            *session,
                 MI_Uint32             flags,
  [in, optional] MI_OperationOptions   *options,
                 const MI_Char         *namespaceName,
  [in]           const MI_Instance     *instanceKey,
                 const MI_Char         *resultClass,
                 const MI_Char         *role,
                 MI_Boolean            keysOnly,
  [in, optional] MI_OperationCallbacks *callbacks,
  [out]          MI_Operation          *operation
);

매개 변수

[in] session

MI_Application_NewSession 반환된 세션 핸들입니다.

flags

RTTI(런타임 형식 정보) 플래그입니다.

[in, optional] options

시간 제한 및 CIM 의미 체계를 제어하는 방법과 같은 옵션을 지정하는 선택적 MI_OperationOptions 값입니다. 전송할 작업 옵션이 없으면 Null 을 지정합니다.

namespaceName

작업을 수행할 네임스페이스 이름을 나타내는 null로 끝나는 선택적 문자열입니다. 지정하지 않으면 서버에서 기본값을 선택합니다. 네임스페이스는 컴퓨터 이름을 포함할 수 없습니다. 슬래시 표시 문자(/)로 구분된 네임스페이스 이름의 형식일 수 있습니다. 예를 들어 유효한 namespaceName 값은 root/cimv2입니다.

[in] instanceKey

참조 작업이 시작될 instance 클래스 이름과 키를 나타내는 MI_Instance.

resultClass

결과 집합을 이 연결 클래스로만 제한하는 값을 나타내는 null로 끝나는 선택적 문자열입니다. 필터링을 원하지 않는 경우 Null 을 지정합니다.

role

키 클래스를 참조하는 데 사용할 연결 클래스의 속성 이름을 지정하는 값을 나타내는 null로 끝나는 선택적 문자열입니다.

keysOnly

MI_TRUE instance 키만 검색하는 것을 의미하는 부울 값입니다. 그렇지 않으면 모든 속성이 검색됩니다.

[in, optional] callbacks

instance 결과 및 CIM 의미 체계를 수신하기 위한 운영 콜백을 정의하는 선택적 MI_OperationCallbacks 구조체입니다. 비동기적으로 작업을 수행하려면 구조체의 instanceResult 콜백 멤버를 지정해야 합니다. 해당 구조체 멤버를 지정하지 않은 경우 클라이언트는 MI_Operation_GetInstance 함수를 호출하여 결과를 검색해야 합니다.

[out] operation

완료되면 MI_Operation_Close 통해 닫아야 하는 반환된 작업 핸들입니다. 완료되기 전에 MI_Operation_Cancel 호출하면 작업이 종료됩니다. MI_Operation_Close 및 MI_Operation_Cancel 모든 작업에서 호출할 수 있습니다.

반환 값

없음

설명

연결은 두 개체 간의 관계입니다. 이 개체는 두 개의 속성을 포함하는 세 번째 개체로 표현되며, 각 개체는 이러한 두 개의 관련 개체 중 하나에 대한 참조입니다. 역할 매개 변수는 연결된 개체를 가리키는 연결 개체의 참조 속성입니다.

이 함수와 MI_Session_AssociatorInstances 함수의 차이점은 이 함수가 연결 개체 자체를 찾는 반면 MI_Session_AssociatorInstances 함수는 키 개체와 연결된 인스턴스를 찾는다는 것입니다.

요구 사항

추가 정보

MI_Application_NewSession

MI_OperationCallbacks

MI_Operation_Cancel

MI_Operation_Close

MI_Operation_GetInstance

MI_Session_AssociatorInstances