DkmProcessLaunchRequest Classe
Definição
Importante
Algumas informações se referem a produtos de pré-lançamento que podem ser substancialmente modificados antes do lançamento. A Microsoft não oferece garantias, expressas ou implícitas, das informações aqui fornecidas.
DkmProcessLaunchRequest é usado para descrever o processo que o depurador deve iniciar.
public ref class DkmProcessLaunchRequest : Microsoft::VisualStudio::Debugger::DkmDataContainer, IDisposable
[System.Runtime.InteropServices.Guid("7107fc56-3477-2708-fc00-174f33c04b08")]
public class DkmProcessLaunchRequest : Microsoft.VisualStudio.Debugger.DkmDataContainer, IDisposable
[<System.Runtime.InteropServices.Guid("7107fc56-3477-2708-fc00-174f33c04b08")>]
type DkmProcessLaunchRequest = class
inherit DkmDataContainer
interface IDisposable
Public Class DkmProcessLaunchRequest
Inherits DkmDataContainer
Implements IDisposable
- Herança
- Atributos
- Implementações
Propriedades
| Arguments |
Adicional Argumentos a serem passados para o arquivo executável na linha de comando. |
| Connection |
Isso representa uma conexão entre o monitor e o IDE. Pode ser uma conexão local se o monitor estiver em execução no mesmo processo que o IDE, ou pode ser uma conexão remota. No processo de monitor, há apenas uma conexão. |
| DebugLaunchSettings |
Configurações fornecidas durante uma operação de depuração de início de um sistema de projeto ou outro chamador de LaunchDebugTargets (ou várias outras APIs de depuração de início). |
| EngineSettings |
Adicional Configurações a serem usadas ao iniciar esse executável no depurador. Isso pode ser omitido se o processo não estiver sendo iniciado no depurador (por exemplo: CTRL-F5). |
| Environment |
Adicional Um ponteiro para o bloco de ambiente para o novo processo. Se esse parâmetro for nulo, o novo processo usará o ambiente do processo de chamada. Um bloco de ambiente consiste em um bloco terminado em nulo de cadeias de caracteres terminadas em nulo. Cada cadeia de caracteres está no seguinte formato: ' name = value\0 '. Como o sinal de igual é usado como um separador, ele não deve ser usado no nome de uma variável de ambiente. |
| FileName |
Caminho para o arquivo executável a ser iniciado. |
| IsUnloaded |
Retornará true se um evento ' Unloaded ' tiver sido gerado para este objeto (exemplo: DkmThread:: Unload é chamado) ou se o objeto foi fechado. Observe que o cuidado deve ser usado ao verificar esse status como, sem sincronização, o status retornado pode não ser mais preciso na instrução após sua leitura. (Herdado de DkmDataContainer) |
| LaunchFlags |
Sinalizadores associados a uma solicitação para iniciar um processo.
|
| ModeFlags |
Sinalize as características de um DkmProcessLaunchRequest. |
| StartupInfo |
Adicional Informações adicionais usadas para iniciar um novo processo. Essas informações estão contidas na estrutura ' STARTUPINFO ' no Win32. |
| UniqueId |
UniqueId identifica exclusivamente a solicitação de inicialização. |
| Win32Flags |
Sinalizadores de criação de processo Win32 usados ao iniciar o processo. Por exemplo, CREATE_NO_WINDOW (0x08000000) pode ser passado para desabilitar a criação da janela do console. Os sinalizadores a seguir nunca devem ser passados e o comportamento será indefinido se estiverem presentes: DEBUG_PROCESS, DEBUG_ONLY_THIS_PROCESS, CREATE_SUSPENDED, EXTENDED_STARTUPINFO_PRESENT, CREATE_SEPARATE_WOW_VDM, CREATE_SHARED_WOW_VDM e CREATE_UNICODE_ENVIRONMENT. |
| WorkingDirectory |
O caminho completo para o diretório atual para o processo. A cadeia de caracteres também pode especificar um caminho UNC. |
Métodos
| Close() |
Fecha uma instância do objeto DkmProcessLaunchRequest. Isso liberará todos os recursos associados a esse objeto em todos os componentes. Isso inclui recursos no computador ou limites de Marshalling gerenciado/nativo. Os objetos DkmProcessLaunchRequest são fechados automaticamente quando seu objeto DkmTransportConnection associado é fechado. Esse método só pode ser chamado pelo componente que criou o objeto. |
| Create(String, String, String, String, DkmProcessStartupInfo, DkmProcessLaunchModeFlags, Int32, DkmTransportConnection, DkmEngineSettings, DkmDebugLaunchSettings, DkmDataItem) |
Crie uma nova instância do objeto DkmProcessLaunchRequest. O chamador é responsável por fechar o objeto criado depois que eles são concluídos. |
| Create(String, String, String, String, DkmProcessStartupInfo, DkmProcessLaunchModeFlags, Int32, DkmTransportConnection, DkmEngineSettings, DkmDebugLaunchSettings, DkmProcessLaunchFlags, DkmDataItem) |
Crie uma nova instância do objeto DkmProcessLaunchRequest. O chamador é responsável por fechar o objeto criado depois que eles são concluídos. Essa API foi introduzida no Visual Studio 14 RTM (DkmApiVersion. VS14RTM). |
| GetDataItem<T>() |
Obtém a instância de ' T' que foi adicionada a esta instância de contêiner. Se esse contêiner não contiver um ' T', essa função retornará NULL. (Herdado de DkmDataContainer) |
| LaunchDebuggedProcess() |
Faz com que o monitor de depuração crie um novo processo sob o depurador. O processo deve permanecer suspenso até que ResumeDebuggedProcess seja chamado. O monitor de depuração deve aguardar ResumeDebuggedProcess antes de criar o objeto DkmProcess, pois ele precisa do valor UniqueProcessId da camada AD7. Observe que esse método só pode ser chamado em resposta ao pacote do depurador do Visual Studio solicitando uma inicialização. Os componentes que desejam iniciar outro processo sob o depurador devem enviar um evento personalizado para um pacote do Visual Studio. A partir de um pacote, uma inicialização pode ser solicitada por meio da API IVsDebugger. LaunchDebugTargets. |
| LaunchProcess(Int32) |
Essa API é uma versão remota da API CreateProcess do Win32. A implementação mesclará o bloco de ambiente, processará o redirecionamento de linha de comando e iniciará o processo. A menos que o sinalizador NODEBUG seja usado, CreateProcess usará o sinalizador DEBUG_PROCESS ao criar o processo Win32. |
| RemoveDataItem<T>() |
Remova a instância de ' T' deste contêiner. Normalmente, é desnecessário chamar esse método, pois um contêiner de dados será automaticamente esvaziado quando o objeto for fechado. (Herdado de DkmDataContainer) |
| ResumeDebuggedProcess(Guid) |
Faz com que o monitor de depuração retome um processo iniciado e crie o objeto DkmProcess. O objeto DkmProcess será criado no thread do evento e a criação do objeto enviará um evento processo Create. Observe que esse método só pode ser chamado em resposta ao pacote do depurador do Visual Studio solicitando uma inicialização. Os componentes que desejam iniciar outro processo sob o depurador devem enviar um evento personalizado para um pacote do Visual Studio. A partir de um pacote, uma inicialização pode ser solicitada por meio da API IVsDebugger. LaunchDebugTargets. |
| ResumeProcess() |
Essa API é usada para retomar um processo que foi iniciado a partir de CreateProcess com o sinalizador LaunchSuspended definido como true. |
| ResumeProcess(DkmProcess) |
Essa API é usada para retomar um processo que foi iniciado a partir de CreateProcess com o sinalizador LaunchSuspended definido como true. Essa API foi introduzida no Visual Studio 15 atualização 3 (DkmApiVersion. VS15Update3). |
| SetDataItem<T>(DkmDataCreationDisposition, T) |
Coloque um novo item no contêiner de dados. (Herdado de DkmDataContainer) |
Implantações explícitas de interface
| IDisposable.Dispose() |
A ser adicionado. |