TestCreate (función)

Devuelve un nuevo identificador de prueba.

Sintaxis

HANDLE TestCreate(
    unsigned int testCaseId,
    unsigned int options,
    unsigned char storage,          
    unsigned int  properties,  
    PCSTR data,                      
    _Out_ GUID* testId);

Parámetros

testCaseId

Identificador de prueba.

opciones

Opciones de recuperación de pruebas. Este parámetro se puede establecer en los valores siguientes.

Value Descripción
0 Opciones predeterminadas
1 Optimice la recuperación con bloqueo, como llamar posteriormente a TestQueryData.
2 En desuso, es la misma que la opción predeterminada.
131 072 Indica que el campo "properties" adicional se incluirá en la estructura TestInfo devuelta desde TestOpen.

storage

Opciones de almacenamiento de prueba. Este parámetro se puede establecer en los valores siguientes.

Value Descripción
1 Los datos se almacenarán en proceso.
2 Los datos se almacenarán fuera del proceso.

properties

Propiedades de prueba. Este parámetro se puede establecer en una combinación de los valores siguientes.

Value Descripción
0 Propiedades predeterminadas.
1 Los datos de prueba no se quitarán del almacenamiento cuando no exista ningún identificador de prueba.
2 Agrega el bit de palabra clave 45 al evento ETW de error una vez por proceso.
4 Agrega el bit de palabra clave 46 a cada evento ETW de error.
8 Agrega el bit de palabra clave 45 al evento ETW correcto.
16 Agrega el bit de palabra clave 46 a cada evento ETW correcto.
32 Establece la expiración de la prueba en 24 horas.
64 Establece la expiración de la prueba en 7 días.
128 Agrega el bit de palabra clave 45 al evento ETW de error.
256 Agrega el bit de palabra clave 45 al evento ETW correcto una vez por proceso.
512 Restringe las métricas de propiedades de eventos ETWBucket a 8 bits.
2048 Incluye el bit de palabra clave 3 en el evento ETW.
4096 Incluye la palabra clave bit 2 en el evento ETW.
8192 Incluye el bit de palabra clave 4 en el evento ETW.

datos

Cadena JSON arbitraria.

testId [out]

Identificador de la instancia de prueba.

Valor devuelto

Identificador de prueba.

Comentarios

Esta función no tiene ninguna biblioteca de importación o archivo de encabezado asociado; se debe invocar mediante las funciones LoadLibrary y GetProcAddress .

Requisitos

Requisito Value
Cliente mínimo compatible Windows Build 22000
Servidor mínimo compatible Windows Server 2022
Encabezado None
Archivo DLL kernelbase.dll