Metodo IDebugClient3::GetRunningProcessSystemIdByExecutableName (dbgeng.h)

Articolo
02/25/2024

Il metodo GetRunningProcessSystemIdByExecutableName cerca un processo con un nome di file eseguibile specificato 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:

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

[out] Id

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

Valore restituito

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

Codice restituito	Descrizione
S_OK	Il metodo è stato eseguito correttamente.
S_FALSE	Più processi corrispondono al nome del file eseguibile in ExeName e DEBUG_GET_PROC_ONLY_MATCH è stato impostato in Flags.
E_NOINTERFACE	Nessun processo corrispondente al nome del file eseguibile in ExeName.