傳回新的測試控制碼。
語法
HANDLE TestCreate(
unsigned int testCaseId,
unsigned int options,
unsigned char storage,
unsigned int properties,
PCSTR data,
_Out_ GUID* testId);
參數
testCaseId
測試識別碼。
選項
測試擷取選項。 這個參數可以設定為下列值。
| 值 | 描述 |
|---|---|
| 0 | 預設選項。 |
| 1 | 使用鎖定優化擷取，例如後續呼叫 TestQueryData。 |
| 2 | 已被取代，這與預設選項相同。 |
| 131072 | 指出TestOpen傳回的TestInfo結構中將會包含其他 「properties」 欄位。 |
儲存
測試儲存體選項。 這個參數可以設定為下列值。
| 值 | 描述 |
|---|---|
| 1 | 資料將會儲存在進程中。 |
| 2 | 資料將會儲存在進程外。 |
properties
測試屬性。 這個參數可以設定為下列值的組合。
| 值 | 描述 |
|---|---|
| 0 | 預設屬性。 |
| 1 | 當沒有任何測試控制碼存在時，將不會從儲存體中移除測試資料。 |
| 2 | 將關鍵字位 45 新增至每個進程一次失敗的 ETW 事件。 |
| 4 | 將關鍵字位 46 新增至每個失敗 ETW 事件。 |
| 8 | 將關鍵字位 45 新增至成功 ETW 事件。 |
| 16 | 將關鍵字位 46 新增至每個成功的 ETW 事件。 |
| 32 | 將測試到期設定為 24 小時。 |
| 64 | 將測試到期設定為 7 天。 |
| 128 | 將關鍵字位 45 新增至失敗 ETW 事件。 |
| 256 | 將關鍵字位 45 新增至每個進程成功的 ETW 事件一次。 |
| 512 | 將 ETW 事件屬性 metricsBucket 限制為 8 位。 |
| 2048 | 在 ETW 事件中包含關鍵字位 3。 |
| 4096 | 在 ETW 事件中包含關鍵字位 2。 |
| 8192 | 在 ETW 事件中包含關鍵字位 4。 |
data
任意 JSON 字串。
testId [out]
測試實例的識別碼。
傳回值
測試控制碼。
備註
此函式沒有相關聯的匯入程式庫或標頭檔;必須使用 LoadLibrary 和 GetProcAddress 函式來叫用它。
規格需求
| 需求 | 值 |
|---|---|
| 最低支援的用戶端 | Windows 組建 22000 |
| 最低支援的伺服器 | Windows Server 2022 |
| 標頭 | 無 |
| DLL | kernelbase.dll |