Process.Handle Propriedade

Definição

Namespace:

System.Diagnostics

Assemblies:

netstandard.dll, System.Diagnostics.Process.dll

Origem:

Process.cs

Obtém o identificador nativo do processo associado.

public:
 property IntPtr Handle { IntPtr get(); };

public IntPtr Handle { get; }

member this.Handle : nativeint

Public ReadOnly Property Handle As IntPtr

Valor da propriedade

IntPtr

nativeint

O identificador que o sistema operacional atribuiu ao processo associado quando o processo foi iniciado. O sistema usa esse identificador para controlar os atributos de processo.

Exceções

InvalidOperationException

O processo não foi iniciado ou foi encerrado. A Handle propriedade não pode ser lida porque não há nenhum processo associado a essa Process instância.

- ou -

A Process instância foi anexada a um processo em execução, mas você não tem as permissões necessárias para obter um identificador com direitos de acesso completos.

NotSupportedException

Você está tentando acessar a Handle propriedade para um processo em execução em um computador remoto. Essa propriedade está disponível apenas para processos em execução no computador local.

Comentários

Um aplicativo pode obter um identificador para um processo que pode ser usado como um parâmetro para muitas funções de controle e informações de processo. Você pode usar esse identificador para inicializar ou WaitHandle chamar métodos nativos com invocação de plataforma.

Esse identificador de processo é privado para um aplicativo. Em outras palavras, os identificadores de processo não podem ser compartilhados. Um processo também tem um processo Id que, ao contrário do Handle, é exclusivo e, portanto, válido em todo o sistema.

Somente processos iniciados por meio de uma chamada para Start definir a Handle propriedade das instâncias correspondentes Process .

Confira também

• Id
• ExitCode
• ExitTime
• HandleCount
• Start()
• Refresh()