Process.Handle Propriedade

  • Referência

Definição

Namespace:
System.Diagnostics
Assembly:
System.Diagnostics.Process.dll
Assembly:
System.dll
Assembly:
netstandard.dll
Origem:
Process.cs
Origem:
Process.cs
Origem:
Process.cs

Obtém o identificador nativo do processo associado.

public:
 property IntPtr Handle { IntPtr get(); };
public IntPtr Handle { get; }
[System.ComponentModel.Browsable(false)]
public IntPtr Handle { get; }
member this.Handle : nativeint
[<System.ComponentModel.Browsable(false)>]
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 manter o controle dos atributos do processo.

Atributos
BrowsableAttribute

Exceções

InvalidOperationException

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

- ou -

A instância de Process 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 completo.

NotSupportedException

Você está tentando acessar a propriedade Handle para um processo que está sendo executado em um computador remoto. Essa propriedade está disponível somente 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 um WaitHandle ou 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 .

Aplica-se a

Confira também