TestCreate 함수

새 테스트 핸들을 반환합니다.

구문

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

매개 변수

testCaseId

테스트 식별자입니다.

옵션

테스트 검색 옵션입니다. 이 매개 변수는 다음 값으로 설정할 수 있습니다.

값	Description
0	기본 옵션입니다.
1	이후에 TestQueryData를 호출하는 것과 같이 잠금을 사용하여 검색을 최적화합니다.
2	더 이상 사용되지 않습니다. 이는 기본 옵션과 동일합니다.
131072	TestOpen에서 반환된 TestInfo 구조체에 추가 "속성" 필드가 포함됨을 나타냅니다.

스토리지

테스트 스토리지 옵션입니다. 이 매개 변수는 다음 값으로 설정할 수 있습니다.

값	Description
1	데이터는 프로세스에 저장됩니다.
2	데이터는 프로세스에서 저장됩니다.

properties

테스트 속성입니다. 이 매개 변수는 다음 값의 조합으로 설정할 수 있습니다.

값	Description
0	기본 속성입니다.
1	테스트 핸들이 없으면 테스트 데이터가 스토리지에서 제거되지 않습니다.
2	프로세스당 한 번씩 실패 ETW 이벤트에 키워드(keyword) 비트 45를 추가합니다.
4	각 오류 ETW 이벤트에 키워드(keyword) 비트 46을 추가합니다.
8	성공 ETW 이벤트에 키워드(keyword) 비트 45를 추가합니다.
16	각 성공 ETW 이벤트에 키워드(keyword) 비트 46을 추가합니다.
32	테스트 만료를 24시간으로 설정합니다.
64	테스트 만료를 7일로 설정합니다.
128	실패 ETW 이벤트에 키워드(keyword) 비트 45를 추가합니다.
256	프로세스당 한 번씩 성공 ETW 이벤트에 키워드(keyword) 비트 45를 추가합니다.
512	ETW 이벤트 속성 메트릭Bucket을 8비트로 제한합니다.
2048	ETW 이벤트에 키워드(keyword) 비트 3을 포함합니다.
4096	ETW 이벤트에 키워드(keyword) 비트 2를 포함합니다.
8192	ETW 이벤트에 키워드(keyword) 비트 4를 포함합니다.

데이터

임의의 JSON 문자열입니다.

testId [out]

테스트 instance 식별자입니다.

반환 값

테스트 핸들입니다.

설명

이 함수에는 연결된 가져오기 라이브러리 또는 헤더 파일이 없습니다. LoadLibrary 및 GetProcAddress 함수를 사용하여 호출해야 합니다.

요구 사항

요구 사항	값
지원되는 최소 클라이언트	Windows 빌드 22000
지원되는 최소 서버	Windows Server 2022
헤더	없음
DLL	kernelbase.dll