IWbemServices::D eleteInstance 메서드(wbemcli.h)

아티클
08/27/2023

IWbemServices::D eleteInstance 메서드는 현재 네임스페이스에서 기존 클래스의 instance 삭제합니다.

구문

HRESULT DeleteInstance(
  [in]  const BSTR      strObjectPath,
  [in]  long            lFlags,
  [in]  IWbemContext    *pCtx,
  [out] IWbemCallResult **ppCallResult
);

매개 변수

[in] strObjectPath

삭제할 instance 대한 개체 경로를 포함하는 유효한 BSTR입니다.

[in] lFlags

다음 값 중 하나가 유효합니다.

WBEM_FLAG_RETURN_IMMEDIATELY

이 플래그를 사용하면 반동기 호출이 됩니다. 자세한 내용은 메서드 호출을 참조하세요.

[in] pCtx

일반적으로 NULL입니다. 그렇지 않으면 instance 삭제하는 공급자가 사용할 수 있는 IWbemContext 개체에 대한 포인터입니다. 컨텍스트 개체의 값은 해당 공급자에 대한 설명서에 지정해야 합니다.

[out] ppCallResult

NULL인 경우 이 매개 변수는 사용되지 않습니다. ppCallResult가 지정된 경우 항목에서 NULL을 가리키도록 설정해야 합니다. lFlags 매개 변수에 WBEM_FLAG_RETURN_IMMEDIATELY 포함된 경우 이 호출은 WBEM_S_NO_ERROR 함께 즉시 반환됩니다. ppCallResult 매개 변수는 새 IWbemCallResult 개체에 대한 포인터를 수신합니다. 그러면 GetCallStatus 메서드를 사용하여 결과를 얻기 위해 폴링할 수 있습니다.

반환 값

이 메서드는 메서드 호출의 상태를 나타내는 HRESULT를 반환합니다. 다음 목록에는 HRESULT 내에 포함된 값이 나열되어 있습니다.

실패 시 COM 함수 GetErrorInfo에서 사용 가능한 정보를 가져올 수 있습니다.

네트워크 문제로 인해 Windows Management에 대한 원격 연결이 끊어지는 경우에도 COM 관련 오류 코드가 반환될 수 있습니다.

설명

현재 네임스페이스에서 기존 instance 삭제하기 위해 IWbemServices::D eleteInstance 메서드가 호출됩니다. 다른 네임스페이스의 인스턴스는 삭제할 수 없습니다. 계층 구조의 클래스에 속하는 instance 삭제하기 위해 DeleteInstance가 호출되면 Windows Management는 계층 구조의 비 추상 클래스를 담당하는 모든 공급자에 대해 DeleteInstanceAsync 메서드를 호출합니다. 즉, strObjectPath 매개 변수가 ClassB의 instance 식별하고 ClassB가 비추상 클래스인 ClassA에서 파생되고 ClassC 및 ClassD의 부모 클래스인 경우 네 클래스 모두에 대한 공급자가 호출됩니다.

Windows Management는 클래스를 가리키도록 수정된 개체 경로를 사용하여 각 공급자를 호출합니다. 예를 들어 원래 호출 에 대한 strObjectPath 가 "ClassB.k=1"로 설정된 경우 ClassA 공급자를 호출하면 strObjectPath 가 "ClassA.k=1"로 설정됩니다.

DeleteInstance 호출의 성공 여부는 최상위 비추상 클래스의 공급자에 대한 DeleteInstanceAsync 호출의 성공에 따라 달라집니다. 추상이 아닌 클래스에는 추상 클래스가 부모로 있습니다. 이러한 클래스 중 하나에 대한 공급자가 성공하면 작업이 성공합니다. 이러한 모든 클래스가 실패하면 작업이 실패합니다.

예를 들어 ClassX가 다음 계층 구조의 기본 클래스라고 가정합니다.

ClassA는 ClassX에서 파생됩니다.
ClassB는 ClassA에서 파생됩니다.
ClassC 및 ClassD는 ClassB에서 파생됩니다.

ClassX가 계층 구조의 유일한 추상 클래스이고 DeleteInstance의 strObjectPath 매개 변수가 ClassB의 instance 가리키는 경우 ClassA에 대한 공급자만 DeleteInstanceAsync 호출에서 성공해야 합니다.

ClassX, ClassA 및 ClassB가 모두 추상이고 DeleteInstance의 strObjectPath 매개 변수가 ClassB의 instance 가리키는 경우 ClassC 공급자 또는 ClassD 공급자가 성공해야 합니다.

요구 사항

요구 사항	값
지원되는 최소 클라이언트	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