TestCreate-Funktion

Gibt ein neues Testhandle zurück.

Syntax

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

Parameter

testCaseId

Der Testbezeichner.

Optionen

Die Testabrufoptionen. Dieser Parameter kann auf die folgenden Werte festgelegt werden.

Wert Beschreibung
0 Standardoption
1 Optimieren Sie den Abruf durch Sperren, z. B. das anschließende Aufrufen von TestQueryData.
2 Veraltet, ist dies die gleiche wie die Standardoption.
131072 Gibt an, dass zusätzliches "Eigenschaften"-Feld in die von TestOpen zurückgegebene TestInfo-Struktur einbezogen wird.

storage

Die Testspeicheroptionen. Dieser Parameter kann auf die folgenden Werte festgelegt werden.

Wert Beschreibung
1 Die Daten werden im Prozess gespeichert.
2 Die Daten werden außerhalb des Prozesses gespeichert.

properties

Die Testeigenschaften. Dieser Parameter kann auf eine Kombination der folgenden Werte festgelegt werden.

Wert Beschreibung
0 Standardeigenschaften.
1 Die Testdaten werden nicht aus dem Speicher entfernt, wenn keine Testhandles vorhanden sind.
2 Fügt einmal pro Prozess Schlüsselwort (keyword) Bit 45 zum Fehler des ETW-Ereignisses hinzu.
4 Fügt jedem ETW-Ereignis Schlüsselwort (keyword) Bit 46 hinzu.
8 Fügt Schlüsselwort (keyword) Bit 45 zum erfolgreichen ETW-Ereignis hinzu.
16 Fügt jedem erfolgreichen ETW-Ereignis Schlüsselwort (keyword) Bit 46 hinzu.
32 Legt den Testablauf auf 24 Stunden fest.
64 Legt den Testablauf auf 7 Tage fest.
128 Fügt Schlüsselwort (keyword) Bit 45 zum FEHLER-ETW-Ereignis hinzu.
256 Fügt einmal pro Prozess Schlüsselwort (keyword) Bit 45 zum erfolgreichen ETW-Ereignis hinzu.
512 Schränkt ETW-EreigniseigenschaftenmetrikenBucket auf 8 Bits ein.
2048 Enthält Schlüsselwort (keyword) Bit 3 im ETW-Ereignis.
4096 Enthält Schlüsselwort (keyword) Bit 2 im ETW-Ereignis.
8192 Enthält Schlüsselwort (keyword) Bit 4 im ETW-Ereignis.

data

Eine beliebige JSON-Zeichenfolge.

testId [out]

Der Bezeichner des Test-instance.

Rückgabewert

Das Testhandle.

Hinweise

Diese Funktion verfügt über keine zugeordnete Importbibliothek oder Headerdatei. Sie muss mit den Funktionen LoadLibrary und GetProcAddress aufgerufen werden.

Anforderungen

Anforderung Wert
Unterstützte Mindestversion (Client) Windows Build 22000
Unterstützte Mindestversion (Server) Windows Server 2022
Header Keine
DLL kernelbase.dll
  • Last updated on