Compartilhar via


Função GetCurrentProcess (processthreadsapi.h)

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

Confira também

CloseHandle

DuplicateHandle

GetCurrentProcessId

GetCurrentThread

Openprocess

Funções de thread e processo

Processos

APIs Vertdll disponíveis em enclaves de VBS