ICorProfilerInfo::GetAppDomainInfo メソッド

アプリケーション ドメイン ID を受け取ります。 そのアプリケーション ドメインを含むプロセスのアプリケーション ドメインの名前と ID を返します。

HRESULT GetAppDomainInfo(
    [in]  AppDomainID appDomainId,
    [in]  ULONG       cchName,
    [out] ULONG       *pcchName,
    [out, size_is(cchName), length_is(*pcchName)]
          WCHAR       szName[] ,
    [out] ProcessID   *pProcessId);

パラメーター

  • appDomainId
    [入力] アプリケーション ドメインの ID。

  • cchName
    [入力] szName 戻りバッファーの長さ (文字単位)。

  • pcchName
    [出力] アプリケーション ドメイン名の文字列長の合計へのポインター。

  • szName
    [出力] 呼び出し元が提供したワイド文字バッファー。 メソッドから戻るとき、szName にはアプリケーション ドメイン名の全部または一部が格納されています。

  • pProcessId
    [出力] アプリケーション ドメインを含むプロセスの ID へのポインター。

解説

このメソッドから制御が戻った後で、szName バッファーがアプリケーション ドメインの完全名を格納できるサイズであることを確認する必要があります。 これを行うには、pcchName が指している値を cchName パラメーターの値と比較します。 pcchName の指す値が cchName の値を超える場合は、szName バッファーの割り当てを増やし、cchName を新しい大きいサイズに更新して、GetAppDomainInfo を再度呼び出します。

別の方法として、最初に GetAppDomainInfo を長さゼロの szName バッファーで呼び出して、適切なバッファーのサイズを取得します。 その後、バッファーのサイズを pcchName で返された値に設定し、GetAppDomainInfo を再度呼び出します。

この 2 つのアプローチの詳細については、「呼び出し元が割り当てたバッファー」を参照してください。

必要条件

プラットフォーム: 「.NET Framework システム要件」を参照

ヘッダー: CorProf.idl、CorProf.h

ライブラリ: CorGuids.lib

.NET Framework のバージョン: 4、3.5 SP1、3.5、3.0 SP1、3.0、2.0 SP1、2.0

参照

参照

ICorProfilerInfo インターフェイス

その他の技術情報

プロファイリングのインターフェイス

プロファイル (アンマネージ API リファレンス)