Share via

IDebugProgramEngines2::EnumPossibleEngines

  • Article

Applies to: yesVisual Studio noVisual Studio for Mac

Note

This article applies to Visual Studio 2017. If you're looking for the latest Visual Studio documentation, see Visual Studio documentation. We recommend upgrading to the latest version of Visual Studio. Download it here

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

Syntax

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