IWbemServices::ExecMethod 메서드(wbemcli.h)
IWbemServices::ExecMethod 메서드는 CIM 개체에서 내보낸 메서드를 실행합니다. 메서드 호출은 실행되는 적절한 공급자로 전달됩니다. 정보 및 상태 호출자에게 반환되며 호출이 완료될 때까지 차단됩니다.
메서드는 Windows Management에서 직접 구현되지 않지만 메서드 공급자가 내보냅니다. 지정된 CIM 클래스의 경우 사용 가능한 메서드와 해당 매개 변수를 해당 공급자에 대한 설명서에 지정해야 합니다.
메서드 실행에 대한 자세한 내용은 메서드 호출을 참조하세요.
구문
HRESULT ExecMethod(
[in] const BSTR strObjectPath,
[in] const BSTR strMethodName,
[in] long lFlags,
[in] IWbemContext *pCtx,
[in] IWbemClassObject *pInParams,
[out] IWbemClassObject **ppOutParams,
[out] IWbemCallResult **ppCallResult
);
매개 변수
[in] strObjectPath
메서드가 실행되는 개체의 개체 경로를 포함하는 유효한 BSTR입니다.
[in] strMethodName
개체의 메서드 이름입니다.
[in] lFlags
이 매개 변수를 0으로 설정하여 동기 호출로 만들 수 있습니다. 이 호출을 반동기 호출로 만들려면 lFlags 를 WBEM_FLAG_RETURN_IMMEDIATELY 설정하고 , ppCallResult 매개 변수에 대한 유효한 포인터를 제공하고, 이 호출은 즉시 반환됩니다. 자세한 내용은 메서드 호출을 참조하세요.
[in] pCtx
일반적으로 NULL; 그렇지 않으면 메서드를 실행하는 공급자가 사용할 수 있는 IWbemContext 개체에 대한 포인터입니다. 컨텍스트 개체의 값은 해당 공급자에 대한 설명서에 지정해야 합니다. 이 매개 변수에 대한 자세한 내용은 WMI 호출을 참조하세요.
[in] pInParams
메서드를 실행하는 데 매개 변수 내가 필요하지 않은 경우 NULL 일 수 있습니다. 그렇지 않으면 메서드 실행에 대한 인바운드 매개 변수 역할을 하는 속성을 포함하는 IWbemClassObject 를 가리킵니다. 개체의 내용은 메서드에 따라 지정되며 해당 공급자에 대한 사양의 일부입니다. 입력 매개 변수를 생성하는 방법에 대한 자세한 내용은 C++에서 매개 변수 개체 만들기를 참조하세요.
[out] ppOutParams
NULL이 아닌 경우 는 아웃바운드 매개 변수에 대한 포인터를 수신하고 메서드 실행에 대한 값을 반환합니다. 이 개체의 내용은 메서드에 따라 지정되며 해당 공급자에 대한 사양의 일부입니다. 호출자는 더 이상 필요하지 않은 경우 반환된 개체에서 Release 를 호출해야 합니다.
[out] ppCallResult
NULL인 경우 사용되지 않습니다. ppCallResult가 지정된 경우 항목에서 NULL을 가리키도록 설정해야 합니다. 이 경우 호출은 WBEM_S_NO_ERROR 사용하여 즉시 반환됩니다. ppCallResult 매개 변수는 GetCallStatus 메서드를 사용하여 메서드 실행 결과를 가져오려면 폴링해야 하는 새 IWbemCallResult 개체에 대한 포인터를 받습니다. 호출에 대한 out 매개 변수는 IWbemCallResult::GetResultObject를 호출하여 사용할 수 있습니다.
반환 값
이 메서드는 메서드 호출의 상태를 나타내는 HRESULT를 반환합니다. 다음 목록에는 HRESULT에 포함된 값이 나열되어 있습니다.
실패 시 COM 함수 GetErrorInfo에서 사용 가능한 정보를 가져올 수 있습니다.
네트워크 문제로 인해 Windows Management에 대한 원격 연결이 끊어지는 경우에도 COM 관련 오류 코드가 반환될 수 있습니다.
설명
ppOutParams가 NULL이 아닌 경우 클라이언트는 ppOutParams가 가리키는 개체의 ReturnValue 속성을 검사하여 메서드의 반환 값 형식을 확인할 수 있습니다.
요구 사항
| 지원되는 최소 클라이언트 | Windows Vista |
| 지원되는 최소 서버 | Windows Server 2008 |
| 대상 플랫폼 | Windows |
| 헤더 | wbemcli.h(Wbemidl.h 포함) |
| 라이브러리 | Wbemuuid.lib |
| DLL | Fastprox.dll; Esscli.dll; FrameDyn.dll; FrameDynOS.dll; Ntevt.dll; Stdprov.dll; Viewprov.dll; Wbemcomn.dll; Wbemcore.dll; Wbemess.dll; Wbemsvc.dll; Wmipicmp.dll; Wmidcprv.dll; Wmipjobj.dll; Wmiprvsd.dll |