iConfigurationDataCollector 介面 (pla.h)

收集時收集計算機設定。 您可以使用組態資訊來驗證系統狀態或追蹤變更。 PLA 會將組態資訊儲存至 IDataCollector：：FileName 屬性中指定的檔案。 檔案的內容是與 TraceRpt.exe 架構一致的 XML。

若要建立此數據收集器，請呼叫 IDataCollectorCollection：：CreateDataCollector或 IDataCollectorCollection：：CreateDataCollectorFromXml 方法。 如需您傳遞至 CreateDataCollectorFromXml 之 XML 的詳細資訊，請參閱。

繼承

IConfigurationDataCollector 介面繼承自 IDataCollector 介面。

方法

IConfigurationDataCollector 介面具有這些方法。

IConfigurationDataCollector：：get_FileMaxCount 擷取或設定要收集的檔案數目上限。 (取得)
IConfigurationDataCollector：：get_FileMaxRecursiveDepth 擷取或設定要從中遞歸收集檔案的子資料夾數目上限。 (取得)
IConfigurationDataCollector：：get_FileMaxTotalSize 擷取或設定您可以收集之所有檔案的總檔案大小上限。 (取得)
IConfigurationDataCollector：：get_Files 擷取或設定要收集的檔案。 (取得)
IConfigurationDataCollector：：get_ManagementQueries 擷取或設定要執行的 Windows Management Instrumentation (WMI) 查詢。 (取得)
IConfigurationDataCollector：：get_QueryNetworkAdapters 擷取或設定值，指出是否已查詢已安裝的網路適配器及其卸除功能和其他組態資訊。 (取得)
IConfigurationDataCollector：：get_RegistryKeys 擷取或設定要收集的登錄機碼清單。
IConfigurationDataCollector：：get_RegistryMaxRecursiveDepth 擷取或設定從中遞歸收集登錄值的最大子機碼數目。 (取得)
IConfigurationDataCollector：：get_SystemStateFile 擷取或設定包含已儲存系統狀態的檔名。 (取得)
IConfigurationDataCollector：:p ut_FileMaxCount 擷取或設定要收集的檔案數目上限。 (Put)
IConfigurationDataCollector：:p ut_FileMaxRecursiveDepth 擷取或設定要從中遞歸收集檔案的子資料夾數目上限。 (Put)
IConfigurationDataCollector：:p ut_FileMaxTotalSize 擷取或設定您可以收集之所有檔案的總檔案大小上限。 (Put)
IConfigurationDataCollector：:p ut_Files 擷取或設定要收集的檔案。 (Put)
IConfigurationDataCollector：:p ut_ManagementQueries 擷取或設定要執行的 Windows Management Instrumentation (WMI) 查詢。 (Put)
IConfigurationDataCollector：:p ut_QueryNetworkAdapters 擷取或設定值，指出是否已查詢已安裝的網路適配器及其卸除功能和其他組態資訊。 (Put)
IConfigurationDataCollector：:p ut_RegistryKeys 擷取或設定要收集的登錄機碼清單。 (Put)
IConfigurationDataCollector：:p ut_RegistryMaxRecursiveDepth 擷取或設定從中遞歸收集登錄值的最大子機碼數目。 (Put)
IConfigurationDataCollector：:p ut_SystemStateFile 擷取或設定包含已儲存系統狀態的檔名。 (Put)

備註

下列範例顯示當您呼叫 CreateDataCollectorFromXml 來建立物件時，可用來初始化這個物件的 XML。 IDataCollector：：Xml 屬性也會傳回這個 XML。

<ConfigurationDataCollector>
    <FileMaxCount/>  
    <FileMaxRecursiveDepth/>  
    <FileMaxTotalSize/>  
    <File/>  <!-- Specify this element for each file -->
    <ManagementQuery/>  <!-- Specify this element for each WMI query -->
    <QueryNetworkAdapters/>
    <RegistryKey/>  <!-- Specify this element for each registry key -->
    <RegistryMaxRecursiveDepth/>
    <SystemStateFile/>  
</ConfigurationDataCollector>

請注意，此範例不會顯示繼承自您也需要指定之 IDataCollector 的屬性元素。

當您指定要建立收集器的 XML 時，您只能指定您想要設定之屬性的專案。 如果您未指定屬性，PLA 會提供預設值。 當您擷取收集器的 XML 時，XML 會提供所有元素，包括 來自 IDataCollector 的專案。

規格需求

需求	值
最低支援的用戶端	Windows Vista [僅限傳統型應用程式]
最低支援的伺服器	Windows Server 2008 [僅限傳統型應用程式]
目標平台	Windows
標頭	pla.h

另請參閱

IDataCollector