SWbemObject.DeleteAsync_ メソッド

SWbemObject の DeleteAsync_ メソッドは、現在のクラスまたは現在のインスタンスを非同期的に削除します。 動的プロバイダーがクラスまたはインスタンスを提供する場合、そのプロバイダーがクラスまたはインスタンスの削除をサポートしていない限り、このオブジェクトを削除できないことがあります。

この構文の説明については、「スクリプト API のドキュメント規則」を参照してください。

構文

SWbemObject.DeleteAsync_( _
  ByVal objWbemSink, _
  [ ByVal iFlags ], _
  [ ByVal objwbemNamedValueSet ], _
  [ ByVal objWbemAsyncContext ] _
)

パラメーター

objWbemSink [in]

削除操作の結果を返すオブジェクト シンク。

iFlags [in、オプション]

呼び出しの動作を決定する整数。 このパラメーターには次の値を指定できます。

wbemFlagSendStatus (128 (0x80))

非同期呼び出しで、オブジェクト シンクの SWbemSink.OnProgress イベント ハンドラーに状態更新を送信します。

wbemFlagDontSendStatus ( 0 (0x0))

非同期呼び出しで、オブジェクト シンクの OnProgress イベント ハンドラーに状態更新を送信しません。

objwbemNamedValueSet [in、オプション]

通常、このパラメータは未定義です。 そうでない場合、これは 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
Header	Wbemdisp.h
タイプ ライブラリ	Wbemdisp.tlb
[DLL]	Wbemdisp.dll
CLSID	CLSID_SWbemObject
IID	IID_ISWbemObject