Metodo IDebugClient3::GetRunningProcessSystemIdByExecutableNameWide (dbgeng.h)

Articolo
02/25/2024

Il metodo GetRunningProcessSystemIdByExecutableNameWide cerca un processo con un nome file eseguibile specificato e restituisce il relativo ID processo.

Sintassi

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

Parametri

[in] Server

Specifica il server di elaborazione per 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 cui eseguire la ricerca.

[in] Flags

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

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à 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 a ExeName.

Valore restituito

Questo metodo può anche restituire valori di errore. Per altre informazioni, vedere Valori restituiti .

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