Metodo IDebugClient3::GetRunningProcessDescription (dbgeng.h)

Articolo
02/23/2024

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 da eseguire una query per la descrizione del processo. Se Server è zero, il motore eseguirà una query sulle informazioni sul processo locale direttamente.

[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. I flag possono contenere i flag di bit seguenti:

Flag	Descrizione
DEBUG_PROC_DESC_NO_PATHS	Restituisce solo nomi di file senza nomi di percorso.
DEBUG_PROC_DESC_NO_SERVICES	Non cercare nomi di servizio.
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 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 della descrizione del buffer. 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 altre informazioni, vedere Valori restituiti .

Codice restituito	Descrizione
S_OK	Il metodo è stato eseguito correttamente.
S_FALSE	Il metodo è stato eseguito correttamente. Tuttavia, ExeNameSize o DescriptionSize erano inferiori alle dimensioni della rispettiva stringa e la stringa è stata troncata per adattarsi all'interno del buffer.