Condividi tramite


Funzione QueryFullProcessImageNameW (winbase.h)

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

Sintassi

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

Parametri

[in] hProcess

Handle per il processo. Questo handle deve essere creato con il diritto di accesso PROCESS_QUERY_INFORMATION o PROCESS_QUERY_LIMITED_INFORMATION. Per altre informazioni, vedere Sicurezza dei processi e diritti di 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 di 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, senza includere il carattere di terminazione Null.

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 versione successiva.

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 del preprocessore UNICODE. La combinazione dell'utilizzo dell'alias indipendente dalla codifica con codice non indipendente dalla codifica può causare mancate corrispondenze che generano errori di compilazione o di runtime. Per altre informazioni, vedere Convenzioni per i prototipi di funzioni.

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