Metodo IDebugClient::GetRunningProcessSystemIdByExecutableName (dbgeng.h)

Articolo
02/06/2025

Il metodo GetRunningProcessSystemIdByExecutableName cerca un processo con un determinato nome di file eseguibile e restituisce il relativo ID processo.

Sintassi

HRESULT GetRunningProcessSystemIdByExecutableName(
  [in]  ULONG64 Server,
  [in]  PCSTR   ExeName,
  [in]  ULONG   Flags,
  [out] PULONG  Id
);

Parametri

[in] Server

Specifica il server di elaborazione in cui cercare il nome eseguibile. Se Server è zero, il motore cercherà il nome eseguibile tra i processi in esecuzione nel computer locale.

[in] ExeName

Specifica il nome del file eseguibile per il quale eseguire la ricerca.

[in] Flags

Specifica un set di bit che controlla la corrispondenza del nome eseguibile. Possono essere presenti i flag seguenti:

Bandiera	Descrizione
DEBUG_GET_PROC_FULL_MATCH	ExeName specifica il nome completo del percorso del file eseguibile. Se questo flag non è impostato, questo metodo non userà i nomi dei percorsi durante la ricerca del processo.
DEBUG_GET_PROC_ONLY_MATCH	Richiedere che solo un processo corrisponda al nome del file eseguibile ExeName.

[out] Id

Riceve l'ID processo del primo processo in modo che corrisponda ExeName.

Valore restituito

Questo metodo può anche restituire valori di errore. Per altri dettagli, vedere valori restituiti.

Codice restituito	Descrizione
S_OK	Il metodo ha avuto esito positivo.
S_FALSE	Più processi corrispondono al nome del file eseguibile in ExeNamee DEBUG_GET_PROC_ONLY_MATCH è stato impostato in Flag.
E_NOINTERFACE	Nessun processo corrispondente al nome del file eseguibile in ExeName.