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 |