Función QueryFullProcessImageNameA (winbase.h)

  • Artículo

Recupera el nombre completo de la imagen ejecutable para el proceso especificado.

Sintaxis

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

Parámetros

[in] hProcess

Identificador del proceso. Este identificador debe crearse con el derecho de acceso PROCESS_QUERY_INFORMATION o PROCESS_QUERY_LIMITED_INFORMATION. Para obtener más información, consulte Derechos de acceso y seguridad de procesos.

[in] dwFlags

Este parámetro puede ser uno de los valores siguientes.

Valor Significado
0
 El nombre debe usar el formato de ruta de acceso Win32.
PROCESS_NAME_NATIVE
0x00000001
 El nombre debe usar el formato de ruta de acceso del sistema nativo.

[out] lpExeName

Ruta de acceso a la imagen ejecutable. Si la función se ejecuta correctamente, esta cadena termina en null.

[in, out] lpdwSize

En la entrada, especifica el tamaño del búfer lpExeName , en caracteres. Si se ejecuta correctamente, recibe el número de caracteres escritos en el búfer, sin incluir el carácter de terminación null.

Valor devuelto

Si la función se realiza correctamente, el valor devuelto es distinto de cero.

Si la función no se realiza correctamente, el valor devuelto es cero. Para obtener información de error extendida, llame a GetLastError.

Comentarios

Para compilar una aplicación que usa esta función, defina _WIN32_WINNT como 0x0600 o posterior.

Nota

El encabezado winbase.h define QueryFullProcessImageName como alias que selecciona automáticamente la versión ANSI o Unicode de esta función en función de la definición de la constante de preprocesador UNICODE. La combinación del uso del alias neutral de codificación con código que no es neutral de codificación puede provocar errores de coincidencia que dan lugar a errores de compilación o tiempo de ejecución. Para obtener más información, vea Convenciones para prototipos de función.

Requisitos

Requisito Value
Cliente mínimo compatible Windows Vista [solo aplicaciones de escritorio]
Servidor mínimo compatible Windows Server 2008 [solo aplicaciones de escritorio]
Plataforma de destino Windows
Encabezado winbase.h (incluye Windows.h)
Library Kernel32.lib
Archivo DLL Kernel32.dll

Vea también

GetModuleFileNameEx

GetProcessImageFileName

Funciones de proceso y subproceso