新しいテスト ハンドルを返します。
構文
HANDLE TestCreate(
unsigned int testCaseId,
unsigned int options,
unsigned char storage,
unsigned int properties,
PCSTR data,
_Out_ GUID* testId);
パラメーター
testCaseId
テスト識別子。
options
テスト取得オプション。 このパラメーターは、次の値に設定できます。
| 値 | 説明 |
|---|---|
| 0 | 既定のオプション。 |
| 1 | 後で TestQueryData を呼び出すのと同様に、ロックを使用して取得を最適化します。 |
| 2 | 非推奨、これは既定のオプションと同じです。 |
| 131072 | TestOpen から返される TestInfo 構造体に、追加の "properties" フィールドが含まれることを示します。 |
storage
テスト ストレージ オプション。 このパラメーターは、次の値に設定できます。
| 値 | 説明 |
|---|---|
| 1 | データはプロセスに格納されます。 |
| 2 | データはプロセス外に格納されます。 |
properties
テスト プロパティ。 このパラメーターは、次の値の組み合わせに設定できます。
| 値 | 説明 |
|---|---|
| 0 | 既定のプロパティ。 |
| 1 | テスト ハンドルが存在しない場合、テスト データはストレージから削除されません。 |
| 2 | エラー ETW イベントキーワード (keyword)ビット 45 をプロセスごとに 1 回追加します。 |
| 4 | 各エラー ETW イベントキーワード (keyword)ビット 46 を追加します。 |
| 8 | 成功した ETW イベントキーワード (keyword)ビット 45 を追加します。 |
| 16 | 各成功 ETW イベントキーワード (keyword)ビット 46 を追加します。 |
| 32 | テストの有効期限を 24 時間に設定します。 |
| 64 | テストの有効期限を 7 日に設定します。 |
| 128 | エラー ETW イベントキーワード (keyword)ビット 45 を追加します。 |
| 256 | 成功した ETW イベントキーワード (keyword)ビット 45 をプロセスごとに 1 回追加します。 |
| 512 | ETW イベント プロパティ メトリックを 8 ビットに制限します。 |
| 2048 | ETW イベントキーワード (keyword)ビット 3 が含まれます。 |
| 4096 | ETW イベントキーワード (keyword)ビット 2 が含まれます。 |
| 8192 | ETW イベントキーワード (keyword)ビット 4 が含まれます。 |
[データ]
任意の JSON 文字列。
testId [out]
テスト インスタンスの識別子。
戻り値
テスト ハンドル。
Remarks
この関数には、インポート ライブラリまたはヘッダー ファイルが関連付けされません。 LoadLibrary 関数と GetProcAddress 関数を使用して呼び出す必要があります。
必要条件
| 要件 | 値 |
|---|---|
| サポートされている最小のクライアント | Windows ビルド 22000 |
| サポートされている最小のサーバー | Windows Server 2022 |
| ヘッダー | なし |
| [DLL] | kernelbase.dll |