Функция 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	Указывает, что дополнительное поле "свойства" будет включено в структуру TestInfo , возвращаемую из TestOpen.

носителей.

Параметры тестового хранилища. Для этого параметра можно задать следующие значения.

Значение	Описание
1	Данные будут храниться в процессе.
2	Данные будут храниться вне процесса.

properties

Свойства теста. Для этого параметра можно задать сочетание следующих значений.

Значение	Описание
0	Свойства по умолчанию.
1	Тестовые данные не будут удалены из хранилища, если не существует тестовых дескрипторов.
2	Добавляет ключевое слово бит 45 к событию трассировки событий windows сбоем один раз для каждого процесса.
4	Добавляет ключевое слово бит 46 к каждому событию трассировки событий windows.
8	Добавляет ключевое слово бит 45 к успешному событию ETW.
16	Добавляет ключевое слово бит 46 к каждому успешному событию ETW.
32	Устанавливает срок действия теста в 24 часа.
64	Устанавливает срок действия теста в 7 дней.
128	Добавляет ключевое слово бит 45 к событию трассировки событий Windows сбоем.
256	Добавляет ключевое слово бит 45 к успешному событию ETW один раз для каждого процесса.
512	Ограничивает метрики свойств событий ETWBucket 8 битами.
2048	Включает ключевое слово бит 3 в событии ETW.
4096	Включает ключевое слово бит 2 в событии ETW.
8192	Включает ключевое слово бит 4 в событии ETW.

.

Произвольная строка JSON.

testId [out]

Идентификатор тестового экземпляра.

Возвращаемое значение

Дескриптор теста.

Комментарии

У этой функции нет связанной библиотеки импорта или файла заголовков; его необходимо вызывать с помощью функций LoadLibrary и GetProcAddress .

Требования

Требование	Значение
Минимальная версия клиента	Сборка Windows 22000
Минимальная версия сервера	Windows Server 2022
Заголовок	Нет
DLL	kernelbase.dll