IDebugEngine2::DestroyProgram

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

Informs a debug engine (DE) that the program specified has been atypically terminated and that the DE should clean up all references to the program and send a program destroy event.

Syntax

HRESULT DestroyProgram( 
   IDebugProgram2* pProgram
);
int DestroyProgram( 
   IDebugProgram2 pProgram
);

Parameters

pProgram
[in] An IDebugProgram2 object that represents the program that has been atypically terminated.

Return Value

If successful, returns S_OK; otherwise, returns an error code.

Remarks

After this method is called, the DE subsequently sends an IDebugProgramDestroyEvent2 event back to the session debug manager (SDM).

This method is not implemented (returns E_NOTIMPL) if the DE runs in the same process as the program being debugged. This method is implemented only if the DE runs in the same process as the SDM.

See also