ICOMAdminCatalog2::D umpApplicationInstance-Methode (comadmin.h)

Artikel
02/26/2024

Erstellt eine Speicherabbilddatei, die ein Image des Status der angegebenen Anwendung instance (Prozess) enthält.

Hinweis Ab Windows Server 2003 verfügen nur Administratoren über Lesezugriffsberechtigungen für die COM+-Abbilddateien.

Syntax

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

Parameter

[in] bstrApplicationInstanceID

Die GUID der Anwendung instance.

[in] bstrDirectory

Der vollständige Pfad zu dem Verzeichnis, in dem die Speicherabbilddatei platziert wird. Schließen Sie den Dateinamen nicht ein. Wenn dieser Parameter NULL ist, lautet das Standardverzeichnis %SystemRoot%\system32\com\dmp.

[in] lMaxImages

Die maximale Anzahl von Speicherabbilddateien, die im Speicherabbildverzeichnis vorhanden sein können. Wenn Sie diese Variable angeben, wird verhindert, dass Speicherabbilddateien zu viel Speicherplatz verbrauchen.

[out, retval] pbstrDumpFile

Der Name der Speicherabbilddatei, die die resultierende Anwendung instance Image enthält.

Rückgabewert

Diese Methode kann die Standardrückgabewerte E_INVALIDARG, E_OUTOFMEMORY, E_UNEXPECTED und E_FAIL sowie die folgenden Werte zurückgeben.

Rückgabecode	BESCHREIBUNG
S_OK	Die Methode wurde erfolgreich abgeschlossen.
COMADMIN_E_APP_NOT_RUNNING	Der angegebene Prozess wird nicht ausgeführt.

Anforderungen

Anforderung	Wert
Unterstützte Mindestversion (Client)	Windows XP [nur Desktop-Apps]
Unterstützte Mindestversion (Server)	Windows Server 2003 [nur Desktop-Apps]
Zielplattform	Windows
Kopfzeile	comadmin.h

Weitere Informationen

ICOMAdminCatalog2

Freigeben über