TestCreate 函数

返回新的测试句柄。

语法

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	指示其他“properties”字段将包含在 TestOpen 返回的 TestInfo 结构中。

存储

测试存储选项。 此参数可以设置为以下值。

值	说明
1	数据将存储在处理中。
2	数据将在进程外存储。

properties

测试属性。 此参数可以设置为以下值的组合。

值	说明
0	默认属性。
1	不存在测试句柄时，不会从存储中删除测试数据。
2	将关键字 (keyword) 位 45 添加到每个进程的失败 ETW 事件一次。
4	将关键字 (keyword) 位 46 添加到每个失败 ETW 事件。
8	将关键字 (keyword) 位 45 添加到成功 ETW 事件。
16	将关键字 (keyword) 位 46 添加到每个成功的 ETW 事件。
32	将测试过期时间设置为 24 小时。
64	将测试过期时间设置为 7 天。
128	将关键字 (keyword) 位 45 添加到失败 ETW 事件。
256	将关键字 (keyword) 位 45 添加到每个进程一次的成功 ETW 事件。
512	将 ETW 事件属性 metricsBucket 限制为 8 位。
2048	在 ETW 事件中包括关键字 (keyword) 位 3。
4096	在 ETW 事件中包括关键字 (keyword) 位 2。
8192	在 ETW 事件中包括关键字 (keyword) 位 4。

数据

任意 JSON 字符串。

testId [out]

测试实例的标识符。

返回值

测试句柄。

备注

此函数没有关联的导入库或头文件;必须使用 LoadLibrary 和 GetProcAddress 函数调用它。

要求

要求	值
最低受支持的客户端	Windows 内部版本 22000
最低受支持的服务器	Windows Server 2022
标头	无
DLL	kernelbase.dll