Share via


IDebugProcess2::Attach

Note

This article applies to Visual Studio 2015. 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

Attaches the session debug manager (SDM) to the process.

Syntax

HRESULT Attach(   
   IDebugEventCallback2* pCallback,  
   GUID*                 rgguidSpecificEngines,  
   DWORD                 celtSpecificEngines,  
   HRESULT*              rghrEngineAttach  
);  
int Attach(   
   IDebugEventCallback2 pCallback,  
   Guid[]               rgguidSpecificEngines,  
   uint                 celtSpecificEngines,  
   int[]                rghrEngineAttach  
);  

Parameters

pCallback
[in] An IDebugEventCallback2 object that is used for debug event notification.

rgguidSpecificEngines
[in] An array of GUIDs of debug engines to be used to debug programs running in the process. This parameter can be a null value. See Remarks for details.

celtSpecificEngines
[in] The number of debug engines in the rgguidSpecificEngines array and the size of the rghrEngineAttach array.

rghrEngineAttach
[in, out] An array of HRESULT codes returned by the debug engines. The size of this array is specified in the celtSpecificEngines parameter. Each code is typically either S_OK or S_ATTACH_DEFERRED. The latter indicates that the DE is currently attached to no programs.

Return Value

If successful, returns S_OK; otherwise, returns an error code. The following table shows other possible values.

Value Description
E_ATTACH_DEBUGGER_ALREADY_ATTACHED The specified process is already attached to the debugger.
E_ATTACH_DEBUGGEE_PROCESS_SECURITY_VIOLATION A security violation occurred during the attach procedure.
E_ATTACH_CANNOT_ATTACH_TO_DESKTOP A desktop process cannot be attached to the debugger.

Remarks

Attaching to a process attaches the SDM to all programs running in that process that can be debugged by the debug engines (DE) specified in the rgguidSpecificEngines array. Set the rgguidSpecificEngines parameter to a null value or include GUID_NULL in the array to attach to all programs in the process.

All debug events that occur in the process are sent to the given IDebugEventCallback2 object. This IDebugEventCallback2 object is provided when the SDM calls this method.

See Also

IDebugProcess2
IDebugEventCallback2