IDebugProgramEngines2::EnumPossibleEngines

Returns the GUIDs for all the possible debug engines (DE) that can debug this program.

Syntax

C#

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

C++

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

Parameters

celtBuffer
[in] The number of DE GUIDs to return. This also specifies the maximum size of the rgguidEngines array.

rgguidEngines
[in, out] An array of DE GUIDs to be filled in.

pceltEngines
[out] Returns the actual number of DE GUIDs that are returned.

Return Value

If successful, returns S_OK; otherwise, returns an error code. Returns [C++] HRESULT_FROM_WIN32(ERROR_INSUFFICIENT_BUFFER) or [C#] 0x8007007A if the buffer is not large enough.

Remarks

In order to determine how many engines there are, call this method once with the celtBuffer parameter set to 0 and the rgguidEngines parameter set to a null value. This returns HRESULT_FROM_WIN32(ERROR_INSUFFICIENT_BUFFER) (0x8007007A for C#), and the pceltEngines parameter returns the necessary size of the buffer.

See also

• IDebugProgramEngines2