IDataCollectorSet

セット内のすべてのデータコレクターオブジェクトに共通する構成情報を管理します。セットへのデータコレクターの追加や削除、およびデータ収集の開始を行います。これは主に使用する PLA インターフェイスです。

スクリプトからこのオブジェクトを作成するには、"Pla.DataCollectorSet" というプログラム識別子を使用します。

既存のデータコレクターセットを取得するには、データコレクターセットオブジェクトのインスタンスを作成し、IDataCollectorSet::Query メソッドを呼び出して、以前に永続化されたデータコレクターセットのプロパティをクエリします。

セットを作成するには、データコレクターセットオブジェクトのインスタンスを作成し、必要に応じてプロパティを設定します。プロパティは個別に設定することも、プロパティ値を含む XML を IDataCollectorSet::SetXml メソッドに渡すこともできます。

新しいデータコレクターオブジェクトをセットに追加するには、IDataCollectorSet::DataCollectors プロパティからコレクションを取得します。データコレクターセットを永続化するには、IDataCollectorSet::Commit メソッドを呼び出します。

データコレクターを手動で開始するには IDataCollectorSet::Start メソッドを使用し、自動的に開始するには IDataCollectorSet::Schedules プロパティを使用します。あるいは、IAlertDataCollector::TriggerDataCollectorSet プロパティが設定されている場合は、アラートによって収集の実行をトリガーできます。

収集したデータを管理する場合は、IDataCollectorSet::DataManager プロパティから IDataManager インターフェイスを取得します。

次の例は、データコレクターセットの XML 要素を示しています。詳細については、対応するプロパティを参照してください。

<DataCollectorSet>
    <DataManager>
        <Enabled/>              <!-- 0 (false), nonzero (true) -->
        <CheckBeforeRunning/>   <!-- 0 (false), nonzero (true) -->
        <MinFreeDisk/>
        <MaxSize/>
        <MaxFolderCount/>
        <ResourcePolicy/>
        <ReportFileName/>
        <RuleTargetFileName/>
        <EventsFileName/>
        <FolderAction>          <!-- Include a <FolderAction> element for -->
            <Actions/>          <!-- each action to take. -->
            <Age/>
            <SendCabTo/>
            <Size/>
        </FolderAction>
    </DataManager>
    <Description/>
    <DescriptionUnresolved/>    <!-- Output only -->
    <DisplayName/>
    <DisplayNameUnresolved/>    <!-- Output only -->
    <Duration/>  
    <Keyword/>                  <!-- Specify for each keyword -->
    <LatestOutputLocation/>     
    <Name/>                     <!-- Output only -->
    <OutputLocation/>           <!-- Output only -->
    <RootPath/>
    <Segment/>
    <SegmentMaxDuration/> 
    <SegmentMaxSize/> 
    <SerialNumber/>
    <Server/>                   <!-- Output only -->
    <Status/>                   <!-- Output only -->
    <Subdirectory/>
    <SubdirectoryFormat/>
    <SubdirectoryFormatPattern/>
    <Task/>
    <TaskArguments/>
    <TaskRunAsSelf/>            <!-- 0 (false), -1 (true) -->
    <TaskUserTextArguments/>
    <Schedule>
        <Days/>
        <EndDate/>              <!-- mm/dd/yyyy -->
        <StartDate/>            <!-- mm/dd/yyyy -->
        <StartTime/>            <!-- hh:mm:ss (use 24-hour clock) -->
    </Schedule>
    <SchedulesEnabled/>         <!-- 0 (false), nonzero (true) -->
    <Security/>                 <!-- Security Descriptor Definition Language -->
    <StopOnCompletion/>         <!-- 0 (false), nonzero (true) -->
    <UserAccount/>              <!-- Output only. Set using SetCredentials --></DataCollectorSet>

セットの XML を取得するために IDataCollectorSet::Xml を呼び出したときに、そのセットにデータコレクターが含まれている場合、XML にはセット内の各データコレクターの XML 要素も含まれます。

データコレクターセットの要素を使用してデータコレクターセットのプロパティ値を初期化するには、SetXml メソッドを呼び出します。XML の内容はセットの既存の内容を上書きします。次に、アラートデータコレクターの要素を含める方法を示します。

<DataCollectorSet>

    <!-- Data collector set elements go here. -->

    <AlertDataCollector>
        <Alert/>  <!-- Specify an <Alert> element for each alert -->
        <EventLog/>
        <SampleInterval/>
        <Task/>
        <TaskArguments/>
        <TaskRunAsSelf/>            <!-- 0 (false), nonzero (true) -->
        <TaskUserTextArguments/>
        <TriggerDataCollectorSet/>

        <!-- Data collector elements go here. -->
    </AlertDataCollector>
</DataCollectorSet>

設定したいプロパティの要素だけを指定できます。プロパティを指定しない場合、PLA は既定値を提供します。セットの XML を取得すると、XML にはセットに含まれるデータコレクターの要素を含め、すべての要素が含まれます（データコレクターのプロパティの詳細については、各データコレクターインターフェイスを参照してください）。ただし、スケジュールおよびフォルダーアクションの要素は、セットに対して定義されていない場合は含まれません。

このセットに含まれるデータコレクターの一覧を取得します。

データコレクターセットが実行される継続時間を取得または設定します。(Get)

データコレクターセットが実行される継続時間を取得または設定します。(Put)

データコレクターセットの説明を取得または設定します。この説明はメタデータとしてすべての出力ファイルに追加され、Performance Data Helper のログにコメントとして挿入されます。(Get)

バイナリからローカライズされた文字列を使用するには、@binary,#id の形式で説明を指定します。ここで binary はローカライズされたリソース文字列を含む EXE または DLL、id は文字列リソース識別子です。

説明を @binary,#id の形式で設定した場合、説明を取得するとローカライズされた文字列が返されます。設定した説明文字列を取得するには、IDataCollectorSet::DescriptionUnresolved プロパティにアクセスします。

データコレクターセットの説明を取得または設定します。この説明はメタデータとしてすべての出力ファイルに追加され、Performance Data Helper のログにコメントとして挿入されます。(Put)

バイナリからローカライズされた文字列を使用するには、@binary,#id の形式で説明を指定します。ここで binary はローカライズされたリソース文字列を含む EXE または DLL、id は文字列リソース識別子です。

説明を @binary,#id の形式で設定した場合、説明を取得するとローカライズされた文字列が返されます。設定した説明文字列を取得するには、IDataCollectorSet::DescriptionUnresolved プロパティにアクセスします。

データコレクターセットの説明を元の形式で取得します。

このプロパティは、IDataCollectorSet::Description プロパティで最初に設定したとおりの説明を返します。通常、@binary,#id の形式で説明を設定した場合にこのプロパティを使用します。

データコレクターセットの表示名を取得または設定します。(Get)

バイナリからローカライズされた文字列を使用するには、@binary,#id の形式で表示名を指定します。ここで binary はローカライズされたリソース文字列を含む EXE または DLL、id は文字列リソース識別子です。

表示名を @binary,#id の形式で設定した場合、表示名を取得するとローカライズされた文字列が返されます。設定した表示名文字列を取得するには、IDataCollectorSet::DisplayNameUnresolved プロパティにアクセスします。

データコレクターセットの表示名を取得または設定します。(Put)

バイナリからローカライズされた文字列を使用するには、@binary,#id の形式で表示名を指定します。ここで binary はローカライズされたリソース文字列を含む EXE または DLL、id は文字列リソース識別子です。

表示名を @binary,#id の形式で設定した場合、表示名を取得するとローカライズされた文字列が返されます。設定した表示名文字列を取得するには、IDataCollectorSet::DisplayNameUnresolved プロパティにアクセスします。

データコレクターセットの表示名を元の形式で取得します。

このプロパティは、IDataCollectorSet::DisplayName プロパティで最初に設定したとおりの表示名を返します。通常、@binary,#id の形式で表示名を設定した場合にこのプロパティを使用します。

データコレクターセットを説明するキーワードを取得または設定します。キーワードの一覧はメタデータとして出力ファイルに追加されます。(Get)

キーワードはファイルの検索時に使用でき、Windows エクスプローラーにも表示されます。

データコレクターセットを説明するキーワードを取得または設定します。キーワードの一覧はメタデータとして出力ファイルに追加されます。(Put)

キーワードはファイルの検索時に使用でき、Windows エクスプローラーにも表示されます。

PLA が最後にログを書き込んだ際に使用した、完全に装飾されたフォルダー名を取得または設定します。(IDataCollectorSet.get_LatestOutputLocation)

通常、このプロパティは設定しません。データコレクターが開始すると、PLA は IDataCollectorSet::OutputLocation プロパティの値を使用してこのプロパティを設定します。

フォルダーが削除されている場合は、このプロパティを空に設定できます。

PLA が最後にログを書き込んだ際に使用した、完全に装飾されたフォルダー名を取得または設定します。(IDataCollectorSet.put_LatestOutputLocation)

通常、このプロパティは設定しません。データコレクターが開始すると、PLA は IDataCollectorSet::OutputLocation プロパティの値を使用してこのプロパティを設定します。

フォルダーが削除されている場合は、このプロパティを空に設定できます。

データコレクターセットを識別するために使用される一意の名前を取得します。

名前は、IDataCollectorSet::Commit メソッドを呼び出したときに設定されます。

PLA が今フォルダーを作成する場合に使用する、装飾されたフォルダー名を取得します。

IDataCollectorSet::LatestOutputLocation プロパティには、コレクターが最後に実行されたときに使用された装飾済みのファイル名が格納されます。

サブディレクトリが作成される基準パスを取得または設定します。(Get)

このプロパティを既定値から変更する場合は、IDataCollectorSet::Start メソッドを呼び出す前に、指定したディレクトリが存在している必要があります。

サブディレクトリが作成される基準パスを取得または設定します。(Put)

このプロパティを既定値から変更する場合は、IDataCollectorSet::Start メソッドを呼び出す前に、指定したディレクトリが存在している必要があります。

データコレクターセットが停止する前に最大サイズまたはセグメントの継続時間に達した場合に、PLA が新しいログを作成するかどうかを示す値を取得または設定します。(Get)

たとえば、現在のログファイルが 100 MB に達したときに新しいログファイルへの書き込みを開始したい場合は、セグメント化を有効にします。新しいログに使用される名前は、IDataCollector::FileNameFormat プロパティによって決まります。

データコレクターセットに関連付けられたタスクは、セグメントが作成されるたびに起動されます。

VARIANT_TRUE の場合、PLA は設定されていれば IDataCollectorSet::SegmentMaxSize プロパティと IDataCollectorSet::SegmentMaxDuration プロパティの両方を使用して、ログをセグメント化するタイミングを判断します。いずれかの制限に達すると、PLA はログをセグメント化します。ログをセグメント化した後、PLA は制限のカウンターをリセットします。

VARIANT_FALSE の場合、PLA は SegmentMaxSize と SegmentMaxDuration を無視します。

データコレクターセットが停止する前に最大サイズまたはセグメントの継続時間に達した場合に、PLA が新しいログを作成するかどうかを示す値を取得または設定します。(Put)

たとえば、現在のログファイルが 100 MB に達したときに新しいログファイルへの書き込みを開始したい場合は、セグメント化を有効にします。新しいログに使用される名前は、IDataCollector::FileNameFormat プロパティによって決まります。

データコレクターセットに関連付けられたタスクは、セグメントが作成されるたびに起動されます。

VARIANT_TRUE の場合、PLA は設定されていれば IDataCollectorSet::SegmentMaxSize プロパティと IDataCollectorSet::SegmentMaxDuration プロパティの両方を使用して、ログをセグメント化するタイミングを判断します。いずれかの制限に達すると、PLA はログをセグメント化します。ログをセグメント化した後、PLA は制限のカウンターをリセットします。

VARIANT_FALSE の場合、PLA は SegmentMaxSize と SegmentMaxDuration を無視します。

データコレクターセットが新しいログファイルへの書き込みを開始するまでに実行できる継続時間を取得または設定します。(Get)

このプロパティを有効にするには、IDataCollectorSet::Segment プロパティを有効にする必要があります。

この継続時間は、IDataCollectorSet::Duration または ISchedule::EndDate プロパティよりも短くする必要があります。

データコレクターセットが新しいログファイルへの書き込みを開始するまでに実行できる継続時間を取得または設定します。(Put)

このプロパティを有効にするには、IDataCollectorSet::Segment プロパティを有効にする必要があります。

この継続時間は、IDataCollectorSet::Duration または ISchedule::EndDate プロパティよりも短くする必要があります。

データコレクターセット内の任意のログファイルの最大サイズを取得または設定します。(Get)

IDataCollectorSet::Segment プロパティが有効な場合、最大サイズに達すると、PLA は書き込み先となる新しいログファイルを作成します。

PLA はログファイルのサイズをこの値に制限しようとしますが、実際のログファイルのサイズはこの値よりわずかに大きくなる場合があります。

データコレクターセット内の任意のログファイルの最大サイズを取得または設定します。(Put)

IDataCollectorSet::Segment プロパティが有効な場合、最大サイズに達すると、PLA は書き込み先となる新しいログファイルを作成します。

PLA はログファイルのサイズをこの値に制限しようとしますが、実際のログファイルのサイズはこの値よりわずかに大きくなる場合があります。

このデータコレクターセットが開始された回数（セグメントを含む）を取得または設定します。(Get)

IDataCollectorSet::SubdirectoryFormat プロパティが plaSerialNumber に設定されている場合に、このプロパティを使用します。

PLA はシリアル番号を使用した後にインクリメントします。

このデータコレクターセットが開始された回数（セグメントを含む）を取得または設定します。(Put)

IDataCollectorSet::SubdirectoryFormat プロパティが plaSerialNumber に設定されている場合に、このプロパティを使用します。

PLA はシリアル番号を使用した後にインクリメントします。

データコレクターセットが実行されるサーバーの名前を取得します。

名前は、IDataCollectorSet::Commit メソッドを呼び出したときに設定されます。

データコレクターセットの状態を取得します。

データコレクターセットの次のインスタンスがログを書き込む、ルートパスの基準サブディレクトリを取得または設定します。(Get)

IDataCollectorSet::SubdirectoryFormat プロパティで書式設定オプションを事前に指定していた場合、実際に使用されるサブディレクトリの名前は異なることがあります。IDataCollectorSet::LatestOutputLocation プロパティには、実際に使用されたフォルダー名が格納されます。

場所が指定されていない場合、ファイルは IDataCollectorSet::RootPath プロパティで指定されたパスに書き込まれます。

PLA は、サブディレクトリパスのフォルダーが存在しない場合はそれらを作成します。フォルダーはルートパスから ACL を継承しないことに注意してください。IDataCollectorSet::UserAccount プロパティで指定されたユーザーと Administrators グループのユーザーは、フォルダーに対する読み取りおよび書き込みアクセス権を持ちます。Performance Log Users グループおよび Performance Monitor Users グループのユーザーは、読み取り専用アクセス権を持ちます。

データコレクターセットの次のインスタンスがログを書き込む、ルートパスの基準サブディレクトリを取得または設定します。(Put)

IDataCollectorSet::SubdirectoryFormat プロパティで書式設定オプションを事前に指定していた場合、実際に使用されるサブディレクトリの名前は異なることがあります。IDataCollectorSet::LatestOutputLocation プロパティには、実際に使用されたフォルダー名が格納されます。

場所が指定されていない場合、ファイルは IDataCollectorSet::RootPath プロパティで指定されたパスに書き込まれます。

PLA は、サブディレクトリパスのフォルダーが存在しない場合はそれらを作成します。フォルダーはルートパスから ACL を継承しないことに注意してください。IDataCollectorSet::UserAccount プロパティで指定されたユーザーと Administrators グループのユーザーは、フォルダーに対する読み取りおよび書き込みアクセス権を持ちます。Performance Log Users グループおよび Performance Monitor Users グループのユーザーは、読み取り専用アクセス権を持ちます。

サブディレクトリ名を装飾する方法を示すフラグを取得または設定します。(Get)

PLA は装飾をフォルダー名に付加します。たとえば、plaMonthDayHour を指定すると、PLA は現在の月、日、時の値をフォルダー名に付加します。フォルダー名が MyFile の場合、結果は MyFile110816 のようになります。

サブディレクトリ名を装飾する方法を示すフラグを取得または設定します。(Put)

PLA は装飾をフォルダー名に付加します。たとえば、plaMonthDayHour を指定すると、PLA は現在の月、日、時の値をフォルダー名に付加します。フォルダー名が MyFile の場合、結果は MyFile110816 のようになります。

フォルダー名を装飾するときに使用する書式パターンを取得または設定します。(Get)

IDataCollectorSet::SubdirectoryFormat プロパティが plaPattern に設定されている場合にのみ、PLA はこのパターンを使用します。

ファイル名に付加する独自のパターンを定義するには、次のパターン文字を使用します。たとえば、パターン "MMMM d, yyyy \a\t h:mmTt" は "January 31, 2005 at 4:20AM" のようになります。

フォルダー名を装飾するときに使用する書式パターンを取得または設定します。(Put)

IDataCollectorSet::SubdirectoryFormat プロパティが plaPattern に設定されている場合にのみ、PLA はこのパターンを使用します。

ファイル名に付加する独自のパターンを定義するには、次のパターン文字を使用します。たとえば、パターン "MMMM d, yyyy \a\t h:mmTt" は "January 31, 2005 at 4:20AM" のようになります。

データコレクターセットが停止するたびに（セグメント間を含む）開始するタスクスケジューラジョブの名前を取得または設定します。(Get)

タスクのコマンドライン引数を指定するには、IDataCollectorSet::TaskArguments および IDataCollectorSet::TaskUserTextArguments を参照してください。

PLA がデータを収集しているディレクトリでタスクを開始するには、タスクの Start in フィールドを $(Arg1) に設定します。

データコレクターセットが停止するたびに（セグメント間を含む）開始するタスクスケジューラジョブの名前を取得または設定します。(Put)

タスクのコマンドライン引数を指定するには、IDataCollectorSet::TaskArguments および IDataCollectorSet::TaskUserTextArguments を参照してください。

PLA がデータを収集しているディレクトリでタスクを開始するには、タスクの Start in フィールドを $(Arg1) に設定します。

タスクをデータコレクターセットのユーザーとして実行するか、タスクで指定されたユーザーとして実行するかを決定する値を取得または設定します。(IDataCollectorSet.get_TaskRunAsSelf)

タスクをデータコレクターセットのユーザーとして実行するか、タスクで指定されたユーザーとして実行するかを決定する値を取得または設定します。(IDataCollectorSet.put_TaskRunAsSelf)

IDataCollectorSet::Task プロパティで指定されたタスクスケジューラジョブに渡すコマンドライン引数を取得または設定します。(Get)

PLA には、引数文字列に含めることができる次の置換変数が用意されています。タスクがトリガーされると、PLA が置換変数の値を提供します。中かっこはエスケープする必要があります（例: {name}）。

通常、置換変数を使用する場合は、中かっこをエスケープする必要のない TaskUserTextArguments でそれらを指定し、このプロパティでは {usertext} を指定します。

IDataCollectorSet::Task プロパティで指定されたタスクスケジューラジョブに渡すコマンドライン引数を取得または設定します。(Put)

PLA には、引数文字列に含めることができる次の置換変数が用意されています。タスクがトリガーされると、PLA が置換変数の値を提供します。中かっこはエスケープする必要があります（例: {name}）。

通常、置換変数を使用する場合は、中かっこをエスケープする必要のない TaskUserTextArguments でそれらを指定し、このプロパティでは {usertext} を指定します。

IDataCollectorSet::TaskArguments プロパティ内の {usertext} 置換変数に置き換えられるコマンドライン引数を取得または設定します。(Get)

これらの引数は、TaskArguments プロパティに {usertext} 置換変数が含まれている場合にのみ、タスクスケジューラジョブに渡されるコマンドライン引数に含められます。

PLA には、引数文字列に含めることができる次の置換変数が用意されています。タスクがトリガーされると、PLA が置換変数の値を提供します。中かっこはエスケープしません。

IDataCollectorSet::TaskArguments プロパティ内の {usertext} 置換変数に置き換えられるコマンドライン引数を取得または設定します。(Put)

これらの引数は、TaskArguments プロパティに {usertext} 置換変数が含まれている場合にのみ、タスクスケジューラジョブに渡されるコマンドライン引数に含められます。

PLA には、引数文字列に含めることができる次の置換変数が用意されています。タスクがトリガーされると、PLA が置換変数の値を提供します。中かっこはエスケープしません。

データコレクターセットがいつ実行されるかを決定するスケジュールの一覧を取得します。

データコレクターセットのインスタンスは一度に 1 つしか実行できません。既に 1 つが実行中に 2 つ目が開始しようとすると、2 つ目は失敗し、1 つ目は続行します。

スケジュールを有効にするには、IDataCollectorSet::SchedulesEnabled プロパティを呼び出します。

データコレクターセットを手動で開始するには、IDataCollectorSet::Start メソッドを呼び出します。

スケジュールが有効かどうかを示す値を取得または設定します。(Get)

このプロパティを使用して、スケジュールに基づくデータ収集セットの実行を一時的に中断できます。

スケジュールが有効かどうかを示す値を取得または設定します。(Put)

このプロパティを使用して、スケジュールに基づくデータ収集セットの実行を一時的に中断できます。

データコレクターセットが実行されるユーザーアカウントを取得します。

ユーザー名は、IDataCollectorSet::SetCredentials メソッドを使用して設定されます。

データコレクターセットのプロパティの値（セットに含まれるデータコレクターのプロパティを含む）を記述する XML 文字列を取得します。

XML 文字列に含まれるプロパティ要素の詳細については、IDataCollectorSet の「解説」セクションと個々のデータコレクターを参照してください。

このデータコレクターセットにアクセスできるユーザーを決定するアクセス制御情報を取得または設定します。(Get)

既定では、ユーザーは完全な特権を持ち、Administrators グループは読み取り、書き込み、実行の特権を持ち、Performance Log Users グループは読み取りおよび実行の特権を持ちます。

このデータコレクターセットにアクセスできるユーザーを決定するアクセス制御情報を取得または設定します。(Put)

既定では、ユーザーは完全な特権を持ち、Administrators グループは読み取り、書き込み、実行の特権を持ち、Performance Log Users グループは読み取りおよび実行の特権を持ちます。

セット内のすべてのデータコレクターが完了状態になったときにデータコレクターセットを停止するかどうかを決定する値を取得または設定します。(Get)

データコレクターセットは、セット内のすべてのデータコレクターが完了した後にのみ停止します。次の表は、各データコレクターがいつ完了するかを示しています。

セット内のすべてのデータコレクターが完了状態になったときにデータコレクターセットを停止するかどうかを決定する値を取得または設定します。(Put)

データコレクターセットは、セット内のすべてのデータコレクターが完了した後にのみ停止します。次の表は、各データコレクターがいつ完了するかを示しています。

このデータコレクターセットに関連付けられたデータマネージャーを取得します。

データコレクターセットが実行されるユーザーアカウントを指定します。

成功した場合、このプロパティは S_OK を返します。

ユーザー資格情報をクリアするには、両方のパラメーターを NULL に設定します。

資格情報を指定しない場合、現在のユーザーが administrator グループのメンバーであれば、PLA はセットを LocalSystem として実行しようとします。

指定されたデータコレクターセットを取得します。

成功した場合は S_OK を返します。次の表に、発生する可能性のあるエラー値を示します。

取得したデータコレクターセットの内容は、このインスタンスの内容を上書きします。インスタンスは空（新規作成）であるか、同じ名前空間のものである必要があります。

セットを保存するために IDataCollectorSet::Commit メソッドを呼び出したときに指定したのと同じ name および server パラメーター値を指定します。

name パラメーターには省略可能な名前空間を含めることができますが、常に名前空間を指定する必要があります。名前空間を指定しない場合、PLA は Windows Vista を実行しているコンピューターでは "Service"、Windows Vista より前のオペレーティングシステムを実行しているコンピューターでは "Legacy" を使用します。次の表に、指定可能な名前空間の値を示します。

Windows Vista より前のオペレーティングシステムを実行しているコンピューターでは、Legacy 名前空間の代わりに Service 名前空間を使用できることに注意してください。

コンピューター上のコミット済みのすべてのセットをクエリするには、IDataCollectorSetCollection::GetDataCollectorSets メソッドを呼び出します。

データコレクターセットを保存、更新、または検証します。このメソッドを使用して、トレースセッションをフラッシュすることもできます。

メソッドの呼び出しが成功した場合は S_OK を返します。値マップにエラーがないか確認する必要があります（「解説」を参照）。メソッドが S_OK を返し、検証エラーがない場合、セットは正常にコミットされています。次の表に、このメソッドを呼び出したときに発生する可能性のあるエラー値を示します。

セットを保存する場合は、セットを取得するために IDataCollectorSet::Query メソッドを呼び出すときに、指定した name および server パラメーター値を使用します。

name パラメーターには省略可能な名前空間を含めることができますが、常に名前空間を指定する必要があります。名前空間を指定しない場合、PLA は Windows Vista を実行しているコンピューターでは "Service"、Windows Vista より前のオペレーティングシステムを実行しているコンピューターでは "Legacy" を使用します。次の表に、指定可能な名前空間の値を示します。

Windows Vista より前のオペレーティングシステムを実行しているコンピューターでは、Legacy 名前空間の代わりに Service 名前空間を使用できることに注意してください。

発生した検証エラーを特定するには、値マップコレクション内の各エラーについて IValueMapItem インターフェイスを取得します。IValueMapItem::Key プロパティにはエラーが発生した要素の XPath が格納されます（例: /AlertDataCollector/TaskArguments）。IValueMapItem::Value プロパティには HRESULT 値が格納され、これはエラーまたは警告（成功コード）のいずれかです。IValueMapItem::Description プロパティにはエラーに関連付けられたメッセージテキストが格納されます。

通常、発生するエラーは、値マップコレクション内の次の HRESULT 値のいずれかになります。

セットが実行中でない場合に、データコレクターセットの永続化されたコピーを削除します。

成功した場合は S_OK を返します。次の表に、発生する可能性のあるエラー値を示します。

データコレクターセットを手動で開始します。

成功した場合は S_OK を返します。次の表に、発生する可能性のあるエラー値を示します。

収集の状態を確認するには、IDataCollectorSet::Status プロパティにアクセスします。

収集プロセスが完了すると、PLA は有効になっていればデータマネージャーを実行します。

スケジュールに従ってデータ収集を自動的に開始するには、IDataCollectorSet::Schedules を参照してください。

セットを非同期に開始した場合、収集プロセスが開始したか（イベント 1003）、または失敗したか（イベント 1004）を示すイベントが Microsoft-Windows-Diagnosis-PLA/Operational イベントログに書き込まれます。

データコレクターセットを手動で停止します。

成功した場合は S_OK を返します。次の表に、発生する可能性のあるエラー値を示します。

このメソッドは、セットが停止したときに、既に収集されたデータを保存します。

Synchronous パラメーターが VARIANT_TRUE の場合、データ管理と収集後に実行されるタスクが完了するまでメソッドは戻らないことに注意してください。

XML に含まれるプロパティのプロパティ値を設定します。(IDataCollectorSet.SetXml)

メソッドの呼び出しが成功した場合は S_OK を返します。値マップにエラーがないか確認する必要があります。メソッドが S_OK を返し、検証エラーがない場合、セットは正常に初期化されています。

XML の構文が有効であれば、1 つ以上のプロパティが無効であっても、この API は S_OK を返します。値が有効なプロパティは設定されます。値が無効なプロパティは既定値に設定されます。

発生したエラーを特定するには、各エラーについて IValueMapItem インターフェイスを取得します。IValueMapItem::Key プロパティにはエラーが発生した要素の XPath が格納され（例: /AlertDataCollector/TaskArguments）、IValueMapItem::Value プロパティにはエラーに関連付けられた HRESULT が格納され、IValueMapItem::Description プロパティにはエラーに関連付けられたメッセージテキストが格納されます。

通常、発生するエラーは次の HRESULT 値のいずれかになります。

ユーザー定義値を設定します。

成功した場合は S_OK を返します。

1 つ以上のユーザー定義値を指定できます。現在存在するキーを指定した場合、現在の値は上書きされます。値を削除するには、pValue パラメーターを NULL に設定します。

IDataCollectorSet::TaskArguments プロパティで変数の置換を実行したい場合は、キー値を使用します。

ユーザー定義値を取得します。

成功した場合は S_OK を返します。