Funzione QueryFullProcessImageNameA (winbase.h)

  • Articolo

Recupera il nome completo dell'immagine eseguibile per il processo specificato.

Sintassi

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

Parametri

[in] hProcess

Handle per il processo. Questo handle deve essere creato con il PROCESS_QUERY_INFORMATION o PROCESS_QUERY_LIMITED_INFORMATION diritto di accesso. Per altre informazioni, vedere Elaborare diritti di sicurezza e accesso.

[in] dwFlags

Questo parametro può avere uno dei valori seguenti.

Valore Significato
0
 Il nome deve usare il formato del percorso Win32.
PROCESS_NAME_NATIVE
0x00000001
 Il nome deve usare il formato del percorso del sistema nativo.

[out] lpExeName

Percorso dell'immagine eseguibile. Se la funzione ha esito positivo, questa stringa viene terminata con null.

[in, out] lpdwSize

In input specifica le dimensioni del buffer lpExeName , in caratteri. In caso di esito positivo, riceve il numero di caratteri scritti nel buffer, non incluso il carattere null-terminazione.

Valore restituito

Se la funzione ha esito positivo, il valore restituito è diverso da zero.

Se la funzione ha esito negativo, il valore restituito è zero. Per informazioni dettagliate sull'errore, chiamare GetLastError.

Commenti

Per compilare un'applicazione che usa questa funzione, definire _WIN32_WINNT come 0x0600 o versioni successive.

Nota

L'intestazione winbase.h definisce QueryFullProcessImageName come alias che seleziona automaticamente la versione ANSI o Unicode di questa funzione in base alla definizione della costante preprocessore UNICODE. La combinazione dell'utilizzo dell'alias di codifica neutrale con il codice non codificato può causare errori di corrispondenza che causano errori di compilazione o runtime. Per altre informazioni, vedere Convenzioni per i prototipi di funzione.

Requisiti

Requisito Valore
Client minimo supportato Windows Vista [solo app desktop]
Server minimo supportato Windows Server 2008 [solo app desktop]
Piattaforma di destinazione Windows
Intestazione winbase.h (include Windows.h)
Libreria Kernel32.lib
DLL Kernel32.dll

Vedere anche

GetModuleFileNameEx

GetProcessImageFileName

Funzioni di processi e thread