Função GetCurrentProcess (processthreadsapi.h)

Artigo
03/05/2024

Recupera um pseudo-identificador para o processo atual.

Sintaxe

HANDLE GetCurrentProcess();

Retornar valor

O valor retornado é um pseudo-identificador para o processo atual.

Comentários

Um pseudo-identificador é uma constante especial, atualmente (HANDLE)-1, que é interpretada como o identificador de processo atual. Para compatibilidade com sistemas operacionais futuros, é melhor chamar GetCurrentProcess em vez de codificar esse valor constante. O processo de chamada pode usar um pseudo-identificador para especificar seu próprio processo sempre que um identificador de processo for necessário. Pseudo-identificadores não são herdados por processos filho.

Esse identificador tem o acesso PROCESS_ALL_ACCESS direito ao objeto de processo. Para obter mais informações, consulte Direitos de acesso e segurança do processo.

Windows Server 2003 e Windows XP: Esse identificador tem o acesso máximo permitido pelo descritor de segurança do processo para o token primário do processo.

Um processo pode criar um identificador "real" para si mesmo que seja válido no contexto de outros processos ou que possa ser herdado por outros processos, especificando o pseudo-identificador como o identificador de origem em uma chamada para a função DuplicateHandle . Um processo também pode usar a função OpenProcess para abrir um identificador real para si mesmo.

O pseudo-identificador não precisa ser fechado quando não é mais necessário. Chamar a função CloseHandle com um pseudo-identificador não tem efeito. Se o pseudo-identificador for duplicado por DuplicateHandle, o identificador duplicado deverá ser fechado.

Exemplos

Para obter um exemplo, consulte Criando um processo filho com entrada e saída redirecionadas.

Requisitos

Requisito	Valor
Cliente mínimo com suporte	Windows XP [aplicativos da área de trabalho \| aplicativos UWP]
Servidor mínimo com suporte	Windows Server 2003 [aplicativos da área de trabalho \| Aplicativos UWP]
Plataforma de Destino	Windows
Cabeçalho	processthreadsapi.h (inclua Windows.h no Windows Server 2003, Windows Vista, Windows 7, Windows Server 2008 Windows Server 2008 R2)
Biblioteca	Kernel32.lib
DLL	Kernel32.dll