ICOMAdminCatalog2::D umpApplicationInstance メソッド (comadmin.h)

  • [アーティクル]

指定したアプリケーション インスタンス (プロセス) の状態のイメージを含むダンプ ファイルを作成します。

メモ Windows Server 2003 の時点では、COM+ ダンプ ファイルに対する読み取りアクセス権を持つのは管理者のみです。
 

構文

HRESULT DumpApplicationInstance(
  [in]          BSTR bstrApplicationInstanceID,
  [in]          BSTR bstrDirectory,
  [in]          long lMaxImages,
  [out, retval] BSTR *pbstrDumpFile
);

パラメーター

[in] bstrApplicationInstanceID

アプリケーション インスタンスの GUID。

[in] bstrDirectory

ダンプ ファイルが配置されるディレクトリへの完全なパス。 ファイル名は含めないでください。 このパラメーターが NULL の場合、既定のディレクトリは %SystemRoot%\system32\com\dmp です。

[in] lMaxImages

ダンプ ディレクトリに存在する可能性があるダンプ ファイルの最大数。 この変数を指定すると、ダンプ ファイルが大量の記憶域を消費することを防ぐことができます。

[out, retval] pbstrDumpFile

結果のアプリケーション インスタンス イメージを含むダンプ ファイルの名前。

戻り値

このメソッドは、E_INVALIDARG、E_OUTOFMEMORY、E_UNEXPECTED、E_FAILの標準戻り値と、次の値を返すことができます。

リターン コード 説明
S_OK
 メソッドは正常に完了しました。
COMADMIN_E_APP_NOT_RUNNING
 指定されたプロセスが実行されていません。

要件

要件 値
サポートされている最小のクライアント Windows XP (デスクトップ アプリのみ)
サポートされている最小のサーバー Windows Server 2003 (デスクトップ アプリのみ)
対象プラットフォーム Windows
ヘッダー comadmin.h

こちらもご覧ください

ICOMAdminCatalog2