次の方法で共有

EnumerateCLRs 関数

  • [アーティクル]

プロセスで CLR を列挙するメカニズムを提供します。

構文

HRESULT EnumerateCLRs (
    [in]  DWORD      debuggeePID,
    [out] HANDLE**   ppHandleArrayOut,
    [out] LPWSTR**   ppStringArrayOut,
    [out] DWORD*     pdwArrayLengthOut
);

パラメーター

debuggeePID
[in] 読み込まれている CLR を列挙するプロセスのプロセス識別子。

ppHandleArrayOut
[out] CLR スタートアップの継続に使用されるイベント ハンドルを含む配列へのポインター。 配列内の各ハンドルが有効であることは保証されません。 ハンドルは、ppStringArrayOut の同じインデックスにある対応するランタイムの継続スタートアップ イベントとして使用されます。

ppStringArrayOut
[out] プロセスに読み込まれている CLR の完全パスを指定する文字列の配列へのポインター。

pdwArrayLengthOut
[out] 同じサイズの ppHandleArrayOut および pdwArrayLengthOut の長さを含む DWORD へのポインター。

値を返す

S_OK
プロセス内の CLR 数が正常に判別され、対応するハンドルとパスの配列が正しく入力されました。

E_INVALIDARG
ppHandleArrayOut または ppStringArrayOut のいずれかが null であるか、または pdwArrayLengthOut が null です。

E_OUTOFMEMORY
ハンドルおよびパス配列に十分なメモリを割り当てることができません。

E_FAIL (またはその他の E_ リターン コード)
読み込まれている CLR を列挙できません。

解説

この関数は、debuggeePID で指定された対象プロセスについて、プロセスに読み込まれている CLR のパスの配列 (ppStringArrayOut)、同じインデックスにある CLR の継続スタートアップ イベントを含むイベント ハンドルの配列 (ppHandleArrayOut)、および読み込まれている CLR の数を示す配列のサイズ (pdwArrayLengthOut) を返します。

Windows オペレーティング システムでは、debuggeePID がプロセス識別子に対応づけられます。

ppHandleArrayOut および ppStringArrayOut のメモリはこの関数によって割り当てられます。 割り当てられているメモリを解放するには、CloseCLREnumeration 関数を呼び出す必要があります。

両方の配列パラメーターを null に設定してこの関数を呼び出すことで、対象プロセス内の CLR の数を取得できます。 この数から、呼び出し元は、作成されるバッファーのサイズを推論できます ((sizeof(HANDLE) * count) + (sizeof(LPWSTR) * count) + (sizeof(WCHAR*) * count * MAX_PATH))。

必要条件

プラットフォーム:.NET supported operating systems をご参照ください。

ヘッダー: dbgshim.h

ライブラリ: dbgshim.dll、libdbgshim.so、libdbgshim.dylib

.NET のバージョン: .NET Core 2.1 以降で使用可能