IDebugProgramProvider2::GetProviderProgramNode

  • Article

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

Retrieves the program node for a specific program.

Syntax

HRESULT GetProviderProgramNode(  
   PROVIDER_FLAGS       Flags,  
   IDebugDefaultPort2*  pPort,  
   AD_PROCESS_ID        processId,  
   REFGUID              guidEngine,  
   UINT64               programId,  
   IDebugProgramNode2** ppProgramNode  
);  

int GetProviderProgramNode(  
   enum_PROVIDER_FLAGS    Flags,  
   IDebugDefaultPort2     pPort,  
   AD_PROCESS_ID          ProcessId,  
   ref Guid               guidEngine,  
   ulong                  programId,  
   out IDebugProgramNode2 ppProgramNode  
);

Parameters

Flags
[in] A combination of flags from the PROVIDER_FLAGS enumeration. The following flags are typical for this call:

Flag Description
PFLAG_REMOTE_PORT Caller is running on remote machine.
PFLAG_DEBUGGEE Caller is currently being debugged (additional information about marshalling will be returned for each node).
PFLAG_ATTACHED_TO_DEBUGGEE Caller was attached to but not launched by the debugger.

pPort
[in] The port the calling process is running on.

processId
[in] An AD_PROCESS_ID structure holding the ID of the process that contains the program in question.

guidEngine
[in] GUID of the debug engine that the program is attached to (if any).

programId
[in] ID of the program for which to get the program node.

ppProgramNode
[out] An IDebugProgramNode2 object representing the requested program node.

Return Value

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

See Also

IDebugProgramProvider2
PROVIDER_FLAGS
AD_PROCESS_ID
IDebugDefaultPort2
IDebugProgramNode2