Metodo IDebugClient5::GetRunningProcessDescription (dbgeng.h)

Articolo
02/06/2025

Il metodo GetRunningProcessDescription restituisce una descrizione del processo che include il nome dell'immagine eseguibile, i nomi dei servizi, i nomi dei pacchetti MTS e la riga di comando.

Sintassi

HRESULT GetRunningProcessDescription(
  [in]            ULONG64 Server,
  [in]            ULONG   SystemId,
  [in]            ULONG   Flags,
  [out, optional] PSTR    ExeName,
  [in]            ULONG   ExeNameSize,
  [out, optional] PULONG  ActualExeNameSize,
  [out, optional] PSTR    Description,
  [in]            ULONG   DescriptionSize,
  [out, optional] PULONG  ActualDescriptionSize
);

Parametri

[in] Server

Specifica il server di elaborazione su cui eseguire una query per la descrizione del processo. Se Server è zero, il motore eseguirà direttamente una query sulle informazioni sul processo locale.

[in] SystemId

Specifica l'ID processo del processo la cui descrizione è desiderata.

[in] Flags

Specifica un set di bit contenente opzioni che influiscono sul comportamento di questo metodo. Flag possono contenere i flag di bit seguenti:

Bandiera	Descrizione
DEBUG_PROC_DESC_NO_PATHS	Restituisce solo nomi di file senza nomi di percorso.
DEBUG_PROC_DESC_NO_SERVICES	Non cercare i nomi dei servizi.
DEBUG_PROC_DESC_NO_MTS_PACKAGES	Non cercare i nomi dei pacchetti MTS.
DEBUG_PROC_DESC_NO_COMMAND_LINE	Non recuperare la riga di comando.

[out, optional] ExeName

Riceve il nome del file eseguibile usato per avviare il processo. Se ExeName è null, queste informazioni non vengono restituite.

[in] ExeNameSize

Specifica le dimensioni in caratteri del buffer ExeNameSize. Questa dimensione include lo spazio per il carattere di terminazione '\0'.

[out, optional] ActualExeNameSize

Riceve le dimensioni in caratteri del nome del file eseguibile. Questa dimensione include lo spazio per il carattere di terminazione '\0'. Se exeNameSize è null, queste informazioni non vengono restituite.

[out, optional] Description

Riceve informazioni aggiuntive sul processo, inclusi i nomi dei servizi, i nomi dei pacchetti MTS e la riga di comando. Se Descrizione è null, queste informazioni non vengono restituite.

[in] DescriptionSize

Specifica le dimensioni in caratteri del buffer Descrizione. Questa dimensione include lo spazio per il carattere di terminazione '\0'.

[out, optional] ActualDescriptionSize

Riceve le dimensioni in caratteri delle informazioni aggiuntive. Questa dimensione include lo spazio per il carattere di terminazione '\0'. Se actualDescriptionSize è null, queste informazioni non vengono restituite.

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	Il metodo ha avuto esito positivo. Tuttavia, ExeNameSize o DescriptionSize erano inferiori alle dimensioni della rispettiva stringa e la stringa è stata troncata per adattarsi all'interno del buffer.