IWbemServices::D eleteClassAsync 메서드(wbemcli.h)
IWbemServices::D eleteClassAsync 메서드는 현재 네임스페이스에서 지정된 클래스를 삭제합니다. 이 메서드는 호출이 즉시 반환된다는 점을 제외하고 IWbemServices::D eleteClass 와 동일합니다. 확인 또는 실패는 작업이 완료된 후 IWbemObjectSink::SetStatus 메서드를 사용하여 지정된 개체 싱크에 비동기적으로 보고됩니다.
구문
HRESULT DeleteClassAsync(
[in] const BSTR strClass,
[in] long lFlags,
[in] IWbemContext *pCtx,
[in] IWbemObjectSink *pResponseHandler
);
매개 변수
[in] strClass
삭제 대상으로 지정된 클래스의 이름입니다.
[in] lFlags
다음 값 중 하나 이상이 유효합니다.
WBEM_FLAG_SEND_STATUS
이 플래그는 클라이언트의 IWbemObjectSink::SetStatus 구현을 통해 중간 상태 보고서를 수신하라는 요청을 Windows Management에 등록합니다. 이 플래그가 동작을 변경하려면 공급자 구현에서 중간 상태 보고를 지원해야 합니다.
WBEM_FLAG_OWNER_UPDATE
푸시 공급자는 DeleteClassAsync 를 호출할 때 이 클래스가 변경되었음을 나타내기 위해 이 플래그를 지정해야 합니다.
[in] pCtx
일반적으로 NULL입니다. 그렇지 않으면 클래스를 삭제하는 공급자가 사용할 수 있는 IWbemContext 개체에 대한 포인터입니다. 컨텍스트 개체의 값은 해당 공급자에 대한 설명서에 지정해야 합니다. 이 매개 변수에 대한 자세한 내용은 WMI 호출을 참조하세요.
[in] pResponseHandler
호출자가 구현한 IWbemObjectSink 구현에 대한 포인터입니다. 이 처리기는 IWbemObjectSink::SetStatus 메서드를 통해 삭제 요청을 사용할 수 있게 되면 삭제 요청의 상태 받습니다. 오류 코드가 반환되면 제공된 IWbemObjectSink 포인터가 사용되지 않습니다. WBEM_S_NO_ERROR 반환되면 작업의 결과를 나타내기 위해 사용자의 IWbemObjectSink 구현이 호출됩니다. Windows Management는 WBEM_S_NO_ERROR 반환되는 경우 포인터에서만 AddRef를 호출합니다. 오류 코드가 반환되는 경우 참조 수는 항목에서와 동일합니다. 이 매개 변수에 대한 자세한 설명은 메서드 호출을 참조하세요.
반환 값
이 메서드는 메서드 호출의 상태를 나타내는 HRESULT를 반환합니다. 다음 목록에는 HRESULT 내에 포함된 값이 나열되어 있습니다.
다른 모든 반환 코드는 SetStatus 메서드를 통해 pReponseHandler 매개 변수에 지정된 개체 싱크에 제공됩니다. 클래스가 없거나 사용자에게 클래스 삭제 권한이 없는 경우와 같은 오류 조건이 처리기에 보고됩니다. 이 메서드의 반환 코드에는 보고되지 않습니다.
네트워크 문제로 인해 Windows Management에 대한 원격 연결이 끊어지는 경우에도 COM 관련 오류 코드가 반환될 수 있습니다.
설명
동적 instance 공급자가 클래스와 연결된 경우 공급자는 등록 취소되고 더 이상 해당 클래스에 대해 호출되지 않습니다. 삭제된 클래스에서 파생된 모든 클래스도 삭제되고 연결된 공급자는 등록 취소됩니다. 지정된 클래스 및 해당 서브클래스의 모든 미해결 정적 인스턴스는 클래스가 삭제될 때도 삭제됩니다.
클래스가 동적 클래스 공급자에서 제공되는 경우 삭제의 성공 여부는 해당 공급자가 클래스 삭제를 지원하는지 여부에 따라 달라집니다.
메서드를 반동적으로 사용하는 방법에 대한 자세한 내용은 IWbemServices::D eleteClass 및 메서드 호출을 참조하세요.
요구 사항
지원되는 최소 클라이언트 | 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 |