IApiTracingDataCollector-Schnittstelle (pla.h)

Protokolliert Win32-Aufrufe für Kernel32.dll, Advapi32.dll, Gdi32.dll und User32.dll. Beachten Sie, dass aus Sicherheitsgründen nicht alle Funktionsaufrufe protokolliert werden.

Um diesen Datensammler zu erstellen, rufen Sie die Methode IDataCollectorCollection::CreateDataCollectorCollection::CreateDataCollectorFromXml auf. Ausführliche Informationen zum XML-Code, den Sie an CreateDataCollectorFromXml übergeben, finden Sie unter Hinweise.

Vererbung

Die IApiTracingDataCollector-Schnittstelle erbt von der IDataCollector-Schnittstelle.

Methoden

Die IApiTracingDataCollector-Schnittstelle verfügt über diese Methoden.

IApiTracingDataCollector::get_ExcludeApis Ruft die Liste der Funktionen ab, die von der Ablaufverfolgung ausgeschlossen werden sollen, oder legt sie fest. (Abrufen)
IApiTracingDataCollector::get_ExePath Ruft den Pfad der ausführbaren Datei ab, deren API-Aufrufe Sie nachverfolgen möchten, oder legt diesen fest. (Abrufen)
IApiTracingDataCollector::get_IncludeApis Ruft die Liste der Funktionen ab, die in die Ablaufverfolgung aufgenommen werden sollen, oder legt sie fest. (Abrufen)
IApiTracingDataCollector::get_IncludeModules Ruft die Liste der Module ab, die in die Ablaufverfolgung eingeschlossen werden sollen, oder legt sie fest. (Abrufen)
IApiTracingDataCollector::get_LogApiNamesOnly Ruft einen Wert ab, der angibt, ob PLA nur den Funktionsnamen protokolliert, oder legt diesen fest. (Abrufen)
IApiTracingDataCollector::get_LogApisRecursively Ruft einen Wert ab, der angibt, ob API-Ablaufverfolgungsprotokolle aufgerufen werden, die direkt von der Anwendung importiert werden, oder legt diesen fest. (Abrufen)
IApiTracingDataCollector::get_LogFilePath Ruft den Namen der Protokolldatei ab, die die API-Ablaufverfolgungsdaten enthält, oder legt diesen fest. (Abrufen)
IApiTracingDataCollector::p ut_ExcludeApis Ruft die Liste der Funktionen ab, die von der Ablaufverfolgung ausgeschlossen werden sollen, oder legt sie fest. (Put)
IApiTracingDataCollector::p ut_ExePath Ruft den Pfad der ausführbaren Datei ab, deren API-Aufrufe Sie nachverfolgen möchten, oder legt diesen fest. (Put)
IApiTracingDataCollector::p ut_IncludeApis Ruft die Liste der Funktionen ab, die in die Ablaufverfolgung aufgenommen werden sollen, oder legt sie fest. (Put)
IApiTracingDataCollector::p ut_IncludeModules Ruft die Liste der Module ab, die in die Ablaufverfolgung eingeschlossen werden sollen, oder legt sie fest. (Put)
IApiTracingDataCollector::p ut_LogApiNamesOnly Ruft einen Wert ab, der angibt, ob PLA nur den Funktionsnamen protokolliert, oder legt diesen fest. (Put)
IApiTracingDataCollector::p ut_LogApisRecursively Ruft einen Wert ab, der angibt, ob API-Ablaufverfolgungsprotokolle aufgerufen werden, die direkt von der Anwendung importiert werden, oder legt diesen fest. (Put)
IApiTracingDataCollector::p ut_LogFilePath Ruft den Namen der Protokolldatei ab, die die API-Ablaufverfolgungsdaten enthält, oder legt diesen fest. (Put)

Hinweise

Das folgende Beispiel zeigt den XML-Code, mit dem Sie dieses Objekt initialisieren können, wenn Sie CreateDataCollectorFromXml aufrufen, um es zu erstellen. Die IDataCollector::Xml-Eigenschaft gibt auch diesen XML-Code zurück.

<ApiTracingDataCollector>
    <ExcludeApis/>
    <ExePath/> 
    <IncludeApis/>
    <IncludeModules/>
    <LogApiNamesOnly/>
    <LogApisRecursively/>
    <LogFilePath/>
</ApiTracingDataCollector>

Beachten Sie, dass im Beispiel nicht die von IDataCollector geerbten Eigenschaftselemente angezeigt werden, die Sie auch angeben müssen.

Wenn Sie den XML-Code zum Erstellen des Collectors angeben, können Sie nur die Elemente für die Eigenschaften angeben, die Sie festlegen möchten. Wenn Sie keine Eigenschaft angeben, stellt PLA einen Standardwert bereit. Wenn Sie den XML-Code für den Collector abrufen, stellt die XML alle Elemente bereit, einschließlich der Elemente aus IDataCollector.

Anforderungen

Anforderung	Wert
Unterstützte Mindestversion (Client)	Windows Vista [nur Desktop-Apps]
Unterstützte Mindestversion (Server)	Windows Server 2008 [nur Desktop-Apps]
Zielplattform	Windows
Kopfzeile	pla.h

Weitere Informationen

IDataCollector