Share via

IDebugProgramEngines2::EnumPossibleEngines

  • Article

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

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

int EnumPossibleEngines( 
   uint      celtBuffer,
   GUID[]    rgguidEngines,
   ref 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

Reference

IDebugProgramEngines2