DkmProcessLaunchEnvironmentFilterList.GetAdditionalEnvironmentVariables Method

Definition

Obtains any environment variables which the extension would like to add.

Location constraint: API must be called from a Monitor component (component level < 100,000).

public:
 System::String ^ GetAdditionalEnvironmentVariables(int ImplementationIndex, Microsoft::VisualStudio::Debugger::Start::DkmDebugLaunchSettings ^ DebugLaunchSettings, Microsoft::VisualStudio::Debugger::Start::DkmProcessLaunchEnvironmentFilterScenario Scenario);
public:
 Platform::String ^ GetAdditionalEnvironmentVariables(int ImplementationIndex, Microsoft::VisualStudio::Debugger::Start::DkmDebugLaunchSettings ^ DebugLaunchSettings, Microsoft::VisualStudio::Debugger::Start::DkmProcessLaunchEnvironmentFilterScenario Scenario);
std::wstring GetAdditionalEnvironmentVariables(int ImplementationIndex, Microsoft::VisualStudio::Debugger::Start::DkmDebugLaunchSettings const & DebugLaunchSettings, Microsoft::VisualStudio::Debugger::Start::DkmProcessLaunchEnvironmentFilterScenario Scenario);
public string GetAdditionalEnvironmentVariables (int ImplementationIndex, Microsoft.VisualStudio.Debugger.Start.DkmDebugLaunchSettings DebugLaunchSettings, Microsoft.VisualStudio.Debugger.Start.DkmProcessLaunchEnvironmentFilterScenario Scenario);
public string? GetAdditionalEnvironmentVariables (int ImplementationIndex, Microsoft.VisualStudio.Debugger.Start.DkmDebugLaunchSettings DebugLaunchSettings, Microsoft.VisualStudio.Debugger.Start.DkmProcessLaunchEnvironmentFilterScenario Scenario);
member this.GetAdditionalEnvironmentVariables : int * Microsoft.VisualStudio.Debugger.Start.DkmDebugLaunchSettings * Microsoft.VisualStudio.Debugger.Start.DkmProcessLaunchEnvironmentFilterScenario -> string
Public Function GetAdditionalEnvironmentVariables (ImplementationIndex As Integer, DebugLaunchSettings As DkmDebugLaunchSettings, Scenario As DkmProcessLaunchEnvironmentFilterScenario) As String

Parameters

ImplementationIndex
Int32

[In] Zero-based index into the collection of {0} implementations that the caller wishes to be invoked. This should be less than the 'Count' property.

DebugLaunchSettings
DkmDebugLaunchSettings

[In] Settings supplied during a start debugging operation from a project system or other caller of LaunchDebugTargets (or various other start debugging APIs).

Scenario
DkmProcessLaunchEnvironmentFilterScenario

[In] Enumeration of the scenarios where IDkmProcessLaunchEnvironmentFilter implementations are invoked.

Returns

[Out,Optional] One or more environment variables which should be passed to the target process. Multiple variables are separated with an embedded null ('\0'). For example: "MyVariable1=1\0MyVariable2=12".

Null or empty string are returned if the caller doesn't want to customize the environment block for this launch.

Applies to