SWbemObject.DeleteAsync_ 메서드
SWbemObject의 DeleteAsync_ 메서드는 현재 클래스 또는 현재 인스턴스를 비동기적으로 삭제합니다. 동적 공급자가 클래스 또는 인스턴스를 제공하는 경우 공급자가 클래스 또는 인스턴스 삭제를 지원하지 않는 한 이 개체를 삭제할 수 없는 경우가 있습니다.
이 구문에 대한 설명은 스크립팅 API의 문서 규칙을 참조하세요.
구문
SWbemObject.DeleteAsync_( _
ByVal objWbemSink, _
[ ByVal iFlags ], _
[ ByVal objwbemNamedValueSet ], _
[ ByVal objWbemAsyncContext ] _
)
매개 변수
-
objWbemSink [in]
-
삭제 작업의 결과를 반환하는 개체 싱크입니다.
-
iFlags [in, optional]
-
호출의 동작을 결정하는 정수입니다. 이 매개 변수는 다음 값을 허용할 수 있습니다.
-
wbemFlagSendStatus (128 (0x80))
-
비동기 호출을 발생하여 개체 싱크에 대한 SWbemSink.OnProgress 이벤트 처리기에 상태 업데이트를 보냅니다.
-
wbemFlagDontSendStatus ( 0 (0x0))
-
비동기 호출이 개체 싱크에 대한 OnProgress 이벤트 처리기로 상태 업데이트를 보내지 않도록 방지합니다.
objwbemNamedValueSet [in, optional]
이 매개 변수는 일반적으로 정의되지 않습니다. 그렇지 않으면 요청을 서비스하는 공급자가 사용할 수 있는 컨텍스트 정보를 나타내는 요소가 있는 SWbemNamedValueSet 개체입니다. 그러한 정보를 지원하거나 요구하는 공급자는 인식된 값 이름, 값의 데이터 형식, 허용된 값 및 의미 체계를 문서화해야 합니다.
objWbemAsyncContext [in, optional]
원래 비동기 호출의 원본을 식별하기 위해 개체 싱크로 반환되는 SWbemNamedValueSet 개체입니다. 동일한 개체 싱크를 사용하여 여러 비동기 호출을 수행하는 경우 이 매개 변수를 사용합니다. 이 매개 변수를 사용하려면 SWbemNamedValueSet 개체를 만들고 SWbemNamedValueSet.Add 메서드를 사용하여 수행 중인 비동기 호출을 식별하는 값을 추가합니다. 이 SWbemNamedValueSet 개체는 개체 싱크로 반환되며 SWbemNamedValueSet.Item 메서드를 사용하여 호출 원본을 추출할 수 있습니다. 자세한 내용은 메서드 호출을 참조하세요.
반환 값
이 메서드는 값을 반환하지 않습니다. 이 호출이 성공하면 제공된 개체 싱크를 통해 삭제 작업의 결과가 제공됩니다.
오류 코드
DeleteAsync_ 메서드가 완료되면 Err 개체에 다음 목록의 오류 코드 중 하나가 포함될 수 있습니다.
-
wbemErrAccessDenied - 2147749891 (0x80041003)
-
현재 컨텍스트에는 개체를 삭제할 수 있는 적절한 보안 권한이 없습니다.
-
wbemErrFailed - 2147749890 (0x80041002)
-
알 수 없는 오류입니다.
-
wbemErrInvalidClass - 2147749904(0x80041010)
-
지정된 클래스가 없습니다.
-
wbemErrInvalidOperation - 2147749910(0x80041016)
-
개체를 삭제할 수 없습니다.
-
wbemErrNotFound - 2147749890(0x80041002)
-
개체가 없습니다.
-
wbemErrOutOfMemory - 2147749894(0x80041006)
-
메모리가 부족하여 작업을 완료할 수 없습니다.
설명
이 호출은 즉시 반환됩니다. 상태는 objWbemSink에 지정된 싱크에 전달된 콜백을 통해 호출자에게 반환됩니다.
비동기 콜백을 사용하면 인증되지 않은 사용자가 싱크에 데이터를 제공할 수 있습니다. 이렇게 하면 스크립트 및 애플리케이션에 보안 위험이 발생합니다. 위험을 제거하려면 반동기 통신 또는 동기 통신을 사용합니다. 자세한 내용은 메서드 호출을 참조하세요.
요구 사항
요구 사항 | 값 |
---|---|
지원되는 최소 클라이언트 |
Windows Vista |
지원되는 최소 서버 |
Windows Server 2008 |
헤더 |
|
유형 라이브러리 |
|
DLL |
|
CLSID |
CLSID_SWbemObject |
IID |
IID_ISWbemObject |