IWbemServices::D eleteInstanceAsync 메서드(wbemcli.h)
IWbemServices::D eleteInstanceAsync 메서드는 현재 네임스페이스에 있는 기존 클래스의 instance 비동기적으로 삭제합니다. 작업의 확인 또는 실패는 호출자가 구현한 IWbemObjectSink 인터페이스를 통해 보고됩니다.
구문
HRESULT DeleteInstanceAsync(
[in] const BSTR strObjectPath,
[in] long lFlags,
[in] IWbemContext *pCtx,
[in] IWbemObjectSink *pResponseHandler
);
매개 변수
[in] strObjectPath
삭제할 개체의 개체 경로를 포함하는 유효한 BSTR입니다.
[in] lFlags
WBEM_FLAG_SEND_STATUS 클라이언트의 IWbemObjectSink::SetStatus 구현을 통해 중간 상태 보고서를 수신하라는 요청을 Windows Management에 등록합니다. 이 플래그가 동작을 변경하려면 공급자 구현에서 중간 상태 보고를 지원해야 합니다. 여기서는 WBEM_FLAG_USE_AMENDED_QUALIFIERS 플래그를 사용할 수 없습니다.
[in] pCtx
일반적으로 NULL입니다. 그렇지 않으면 instance 삭제하는 공급자가 사용할 수 있는 IWbemContext 개체에 대한 포인터입니다. 컨텍스트 개체의 값은 해당 공급자에 대한 설명서에 지정해야 합니다.
[in] pResponseHandler
호출자의 IWbemObjectSink 구현에 대한 포인터입니다. 이 처리기는 SetStatus 메서드를 통해 사용할 수 있게 되면 삭제 작업의 상태 받습니다. 오류 코드가 반환되면 제공된 IWbemObjectSink 포인터가 사용되지 않습니다. WBEM_S_NO_ERROR 반환되면 작업의 결과를 나타내기 위해 사용자의 IWbemObjectSink 구현이 호출됩니다. Windows Management는 WBEM_S_NO_ERROR 반환되는 경우 포인터에서만 AddRef를 호출합니다. 오류 코드가 반환되는 경우 참조 수는 항목에서와 동일합니다. 자세한 내용은 메서드 호출을 참조하세요.
반환 값
이 메서드는 메서드 호출의 상태를 나타내는 HRESULT를 반환합니다. 다음 목록에는 HRESULT 내에 포함된 값이 나열되어 있습니다.
실패 시 COM 함수 GetErrorInfo에서 사용 가능한 정보를 가져올 수 있습니다.
DeleteInstanceAsync가 WBEM_S_NO_ERROR 반환하는 경우 WMI는 응답 처리기의 SetStatus 메서드에서 결과를 기다립니다. WMI는 로컬 연결에서 무기한 대기하거나 원격 연결 제한 시간이 발생할 때까지 대기합니다.
다른 오류 조건은 pResponseHandler 매개 변수에서 제공하는 개체 싱크에 비동기적으로 보고됩니다.
네트워크 문제로 인해 Windows Management에 대한 원격 연결이 끊어지는 경우에도 COM 관련 오류 코드가 반환될 수 있습니다.
설명
instance 공급자는 DeleteInstanceAsync의 반환 코드를 사용하거나 pResponseHandler를 통해 SetStatus를 호출하여 성공 또는 실패를 보고할 수 있습니다. SetStatus로 전송되는 경우 pResponseHandler를 통해 싱크로 전송된 반환 코드가 우선합니다. 콜백은 클라이언트에서 요구하는 것과 동일한 인증 수준에서 반환되지 않을 수 있으므로 비동기 통신 대신 반동기를 사용하는 것이 좋습니다. 비동기 통신이 필요한 경우 메서드 호출을 참조하세요.
메서드를 반동적으로 사용하는 방법에 대한 자세한 내용은 IWbemServices::D eleteInstance 및 메서드 호출을 참조하세요.
요구 사항
| 지원되는 최소 클라이언트 | 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 |