Функция 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
  • Last updated on