Metodo ICOMAdminCatalog2::D umpApplicationInstance (comadmin.h)

Articolo
02/26/2024

Crea un file di dump contenente un'immagine dello stato dell'istanza dell'applicazione specificata (processo).

Nota A partire da Windows Server 2003, solo gli amministratori hanno privilegi di accesso in lettura ai file di dump COM+.

Sintassi

HRESULT DumpApplicationInstance(
  [in]          BSTR bstrApplicationInstanceID,
  [in]          BSTR bstrDirectory,
  [in]          long lMaxImages,
  [out, retval] BSTR *pbstrDumpFile
);

Parametri

[in] bstrApplicationInstanceID

GUID dell'istanza dell'applicazione.

[in] bstrDirectory

Percorso completo della directory in cui viene inserito il file dump. Non includere il nome del file. Se questo parametro è NULL, la directory predefinita è %SystemRoot%\system32\com\dmp.

[in] lMaxImages

Numero massimo di file di dump che possono esistere nella directory dump. Se si specifica questa variabile, i file di dump non consumano troppo spazio di archiviazione.

[out, retval] pbstrDumpFile

Nome del file dump contenente l'immagine dell'istanza dell'applicazione risultante.

Valore restituito

Questo metodo può restituire i valori restituiti standard E_INVALIDARG, E_OUTOFMEMORY, E_UNEXPECTED e E_FAIL, nonché i valori seguenti.

Codice restituito	Descrizione
S_OK	Metodo completato correttamente.
COMADMIN_E_APP_NOT_RUNNING	Il processo specificato non è in esecuzione.

Requisiti

Requisito	Valore
Client minimo supportato	Windows XP [solo app desktop]
Server minimo supportato	Windows Server 2003 [solo app desktop]
Piattaforma di destinazione	Windows
Intestazione	comadmin.h

Vedi anche

ICOMAdminCatalog2

Condividi tramite