Méthode ICOMAdminCatalog2 ::D umpApplicationInstance (comadmin.h)

Article
02/24/2024

Crée un fichier de vidage contenant une image de l’état du instance d’application (processus) spécifié.

Note Depuis Windows Server 2003, seuls les administrateurs disposent de privilèges d’accès en lecture aux fichiers de vidage COM+.

Syntaxe

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

Paramètres

[in] bstrApplicationInstanceID

GUID de l’application instance.

[in] bstrDirectory

Chemin d’accès complet au répertoire dans lequel le fichier de vidage est placé. N’incluez pas le nom de fichier. Si ce paramètre a la valeur NULL, le répertoire par défaut est %SystemRoot%\system32\com\dmp.

[in] lMaxImages

Nombre maximal de fichiers de vidage qui peuvent exister dans le répertoire de vidage. La spécification de cette variable empêche les fichiers de vidage de consommer trop d’espace de stockage.

[out, retval] pbstrDumpFile

Nom du fichier de vidage contenant l’image instance d’application résultante.

Valeur retournée

Cette méthode peut retourner les valeurs de retour standard E_INVALIDARG, E_OUTOFMEMORY, E_UNEXPECTED et E_FAIL, ainsi que les valeurs suivantes.

Code de retour	Description
S_OK	La commande s'est correctement terminée.
COMADMIN_E_APP_NOT_RUNNING	Le processus spécifié n’est pas en cours d’exécution.

Configuration requise

Condition requise	Valeur
Client minimal pris en charge	Windows XP [applications de bureau uniquement]
Serveur minimal pris en charge	Windows Server 2003 [applications de bureau uniquement]
Plateforme cible	Windows
En-tête	comadmin.h

Voir aussi

ICOMAdminCatalog2

Partager via