Partager via


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

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