IDebugProgramEngines2::EnumPossibleEngines

このプログラムをデバッグできるすべてのデバッグ エンジン (DE) の GUID を返します。

構文

C#

int EnumPossibleEngines( 
   uint      celtBuffer,
   GUID[]    rgguidEngines,
   ref DWORD pceltEngines
);

C++

HRESULT EnumPossibleEngines( 
   DWORD  celtBuffer,
   GUID*  rgguidEngines,
   DWORD* pceltEngines
);

パラメーター

celtBuffer
[入力] 返す DE GUID の数。 これで、rgguidEngines 配列の最大サイズも指定されます。

rgguidEngines
[入力、出力] 入力される DE GUID の配列。

pceltEngines
[出力] 返される DE GUID の実際の数を返します。

戻り値

成功した場合は、S_OK を返します。それ以外の場合は、エラー コードを返します。 バッファーの大きさが十分でない場合は、[C++] HRESULT_FROM_WIN32(ERROR_INSUFFICIENT_BUFFER) または [C#] 0x8007007A を返します。

解説

存在するエンジンの数を確認するには、celtBuffer パラメーターを 0 に設定し、rgguidEngines パラメーターを null 値に設定して、このメソッドを 1 回呼び出します。 これで HRESULT_FROM_WIN32(ERROR_INSUFFICIENT_BUFFER) (C# の場合は 0x8007007A) が返され、pceltEngines パラメーターではバッファーに必要なサイズが返されます。

関連項目

• IDebugProgramEngines2