Função QueryFullProcessImageNameW (winbase.h)

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

Sintaxe

BOOL QueryFullProcessImageNameW(
  [in]      HANDLE hProcess,
  [in]      DWORD  dwFlags,
  [out]     LPWSTR 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. A combinação do 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 (inclua Windows.h)
Biblioteca	Kernel32.lib
DLL	Kernel32.dll

Confira também

GetModuleFileNameEx

GetProcessImageFileName

Funções de thread e processo