Função GetProcessId (processthreadsapi.h)

Recupera o identificador de processo do processo especificado.

Sintaxe

DWORD GetProcessId(
  [in] HANDLE Process
);

Parâmetros

[in] Process

Um identificador para o processo. O identificador deve ter o direito de acesso PROCESS_QUERY_INFORMATION ou PROCESS_QUERY_LIMITED_INFORMATION. Para obter mais informações, consulte Direitos de acesso e segurança do processo.

Windows Server 2003 e Windows XP: O identificador deve ter o direito de acesso PROCESS_QUERY_INFORMATION.

Retornar valor

Se a função for bem-sucedida, o valor retornado será o identificador do processo.

Se a função falhar, o valor retornado será zero. Para obter informações de erro estendidas, chame GetLastError.

Comentários

Até que um processo seja encerrado, seu identificador de processo o identifica exclusivamente no sistema. Para obter mais informações sobre direitos de acesso, consulte Direitos de acesso e segurança do processo.

Requisitos

Requisito Valor
Cliente mínimo com suporte Windows Vista, Windows XP com SP1 [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

GetCurrentProcessId

GetProcessIdOfThread

GetThreadId

Processos