TestCreate (Fungsi TestCreate)

Mengembalikan handel pengujian baru.

Sintaks

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

Parameter

testCaseId

Pengidentifikasi pengujian.

opsi

Opsi pengambilan pengujian. Parameter ini dapat diatur ke nilai berikut.

Nilai	Deskripsi
0	Opsi default.
1	Optimalkan pengambilan dengan penguncian, seperti kemudian memanggil TestQueryData.
2	Tidak digunakan lagi, ini sama dengan opsi default.
131072	Menunjukkan bahwa bidang "properti" tambahan akan disertakan dalam struktur TestInfo yang dikembalikan dari TestOpen.

penyimpanan

Opsi penyimpanan pengujian. Parameter ini dapat diatur ke nilai berikut.

Nilai	Deskripsi
1	Data akan disimpan dalam proses.
2	Data akan disimpan di luar proses.

properti

Properti pengujian. Parameter ini dapat diatur ke kombinasi nilai berikut.

Nilai	Deskripsi
0	Properti default.
1	Data pengujian tidak akan dihapus dari penyimpanan ketika tidak ada handel pengujian.
2	Menambahkan kata kunci bit 45 ke peristiwa ETW kegagalan sekali per proses.
4	Menambahkan kata kunci bit 46 ke setiap peristiwa ETW kegagalan.
8	Menambahkan kata kunci bit 45 ke acara ETW yang sukses.
16	Menambahkan kata kunci bit 46 ke setiap peristiwa ETW yang berhasil.
32	Mengatur kedaluwarsa pengujian menjadi 24 jam.
64	Mengatur kedaluwarsa pengujian menjadi 7 hari.
128	Menambahkan kata kunci bit 45 ke peristiwa ETW kegagalan.
256	Menambahkan kata kunci bit 45 ke peristiwa ETW yang sukses sekali per proses.
512	Membatasi metrik properti peristiwa ETWBucket ke 8 bit.
2048	Menyertakan kata kunci bit 3 dalam peristiwa ETW.
4096	Menyertakan kata kunci bit 2 dalam peristiwa ETW.
8192	Menyertakan kata kunci bit 4 dalam peristiwa ETW.

data

String JSON arbitrer.

testId [out]

Pengidentifikasi instans pengujian.

Menampilkan nilai

Handel pengujian.

Keterangan

Fungsi ini tidak memiliki pustaka impor atau file header terkait; harus dipanggil menggunakan fungsi LoadLibrary dan GetProcAddress .

Persyaratan

Persyaratan	Nilai
Klien minimum yang didukung	Windows Build 22000
Server minimum yang didukung	Windows Server 2022
Header	Tidak ada
DLL	kernelbase.dll