Fonction TestCreate

Retourne un nouveau handle de test.

Syntaxe

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

Paramètres

testCaseId

Identificateur de test.

options

Options de récupération des tests. Ce paramètre peut être défini sur les valeurs suivantes.

Valeur	Description
0	Option par défaut.
1	Optimisez la récupération avec le verrouillage, comme l’appel ultérieur de TestQueryData.
2	Déconseillé, il s’agit de l’option par défaut.
131 072	Indique que le champ « propriétés » supplémentaire sera inclus dans la structure TestInfo retournée à partir de TestOpen.

storage

Options de stockage de test. Ce paramètre peut être défini sur les valeurs suivantes.

Valeur	Description
1	Les données seront stockées en cours de traitement.
2	Les données seront stockées hors processus.

properties

Propriétés de test. Ce paramètre peut être défini sur une combinaison des valeurs suivantes.

Valeur	Description
0	Propriétés par défaut.
1	Les données de test ne sont pas supprimées du stockage lorsqu’il n’existe aucun handle de test.
2	Ajoute mot clé bit 45 à l’événement ETW défaillant une fois par processus.
4	Ajoute mot clé bit 46 à chaque événement ETW d’échec.
8	Ajoute mot clé bit 45 à l’événement ETW réussi.
16	Ajoute mot clé bit 46 à chaque événement ETW réussi.
32	Définit l’expiration du test sur 24 heures.
64	Définit l’expiration du test sur 7 jours.
128	Ajoute mot clé bit 45 à l’événement ETW défaillant.
256	Ajoute mot clé bit 45 à l’événement ETW réussi une fois par processus.
512	Limite les métriques de propriété d’événement ETWBucket à 8 bits.
2 048	Inclut mot clé bit 3 dans l’événement ETW.
4096	Inclut mot clé bit 2 dans l’événement ETW.
8 192	Inclut mot clé bit 4 dans l’événement ETW.

data

Chaîne JSON arbitraire.

testId [out]

Identificateur du instance de test.

Valeur retournée

Handle de test.

Remarques

Cette fonction n’a aucune bibliothèque d’importation ou fichier d’en-tête associé ; il doit être appelé à l’aide des fonctions LoadLibrary et GetProcAddress .

Configuration requise

Condition requise	Valeur
Client minimal pris en charge	Windows Build 22000
Serveur minimal pris en charge	Windows Server 2022
En-tête	Aucun
DLL	kernelbase.dll