Função QueryFullProcessImageNameA (winbase.h)

  • Artigo

Recupera o nome completo da imagem executável para o processo especificado.

Sintaxe

BOOL QueryFullProcessImageNameA(
  [in]      HANDLE hProcess,
  [in]      DWORD  dwFlags,
  [out]     LPSTR  lpExeName,
  [in, out] PDWORD lpdwSize
);

Parâmetros

[in] hProcess

Um identificador para o processo. Esse identificador deve ser criado com 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.

[in] dwFlags

Esse parâmetro pode usar um dos valores a seguir.

Valor Significado
0
 O nome deve usar o formato de caminho win32.
PROCESS_NAME_NATIVE
0x00000001
 O nome deve usar o formato de caminho do sistema nativo.

[out] lpExeName

O caminho para a imagem executável. Se a função for bem-sucedida, essa cadeia de caracteres será terminada em nulo.

[in, out] lpdwSize

Na entrada, especifica o tamanho do buffer lpExeName , em caracteres. Em caso de êxito, recebe o número de caracteres gravados no buffer, não incluindo o caractere de terminação nula.

Valor retornado

Se a função for bem-sucedida, o valor retornado será diferente de zero.

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

Comentários

Para compilar um aplicativo que usa essa função, defina _WIN32_WINNT como 0x0600 ou posterior.

Observação

O cabeçalho winbase.h define QueryFullProcessImageName como um alias que seleciona automaticamente a versão ANSI ou Unicode dessa função com base na definição da constante de pré-processador UNICODE. Misturar o uso do alias neutro de codificação com código que não é neutro em codificação pode levar a incompatibilidades que resultam em erros de compilação ou de runtime. Para obter mais informações, consulte Convenções para protótipos de função.

Requisitos

Requisito Valor
Cliente mínimo com suporte Windows Vista [somente aplicativos da área de trabalho]
Servidor mínimo com suporte Windows Server 2008 [somente aplicativos da área de trabalho]
Plataforma de Destino Windows
Cabeçalho winbase.h (incluir Windows.h)
Biblioteca Kernel32.lib
DLL Kernel32.dll

Confira também

GetModuleFileNameEx

GetProcessImageFileName

Funções de thread e processo