Função TestCreate

Retorna um novo identificador de teste.

Sintaxe

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

Parâmetros

testCaseId

O identificador de teste.

opções

As opções de recuperação de teste. Esse parâmetro pode ser definido para os valores a seguir.

Valor Descrição
0 Opção padrão.
1 Otimize a recuperação com bloqueio, como chamar TestQueryData posteriormente.
2 Preterido, essa é a mesma opção padrão.
131072 Indica que o campo "propriedades" adicional será incluído na estrutura TestInfo retornada de TestOpen.

armazenamento

As opções de armazenamento de teste. Esse parâmetro pode ser definido para os valores a seguir.

Valor Descrição
1 Os dados serão armazenados em processo.
2 Os dados serão armazenados fora do processo.

properties

As propriedades de teste. Esse parâmetro pode ser definido como uma combinação dos valores a seguir.

Valor Descrição
0 Propriedades padrão.
1 Os dados de teste não serão removidos do armazenamento quando nenhum identificador de teste existir.
2 Adiciona palavra-chave bit 45 ao evento ETW de falha uma vez por processo.
4 Adiciona palavra-chave bit 46 a cada evento ETW de falha.
8 Adiciona palavra-chave bit 45 ao evento ETW de sucesso.
16 Adiciona palavra-chave bit 46 a cada evento ETW de êxito.
32 Define a expiração do teste como 24 horas.
64 Define a expiração do teste como 7 dias.
128 Adiciona palavra-chave bit 45 ao evento ETW de falha.
256 Adiciona palavra-chave bit 45 ao evento ETW de sucesso uma vez por processo.
512 Restringe as métricas da propriedade de evento ETWBucket a 8 bits.
2.048 Inclui palavra-chave bit 3 no evento ETW.
4096 Inclui palavra-chave bit 2 no evento ETW.
8192 Inclui palavra-chave bit 4 no evento ETW.

data

Uma cadeia de caracteres JSON arbitrária.

testId [out]

O identificador da instância de teste.

Retornar valor

O identificador de teste.

Comentários

Essa função não tem biblioteca de importação ou arquivo de cabeçalho associado; ele deve ser invocado usando as funções LoadLibrary e GetProcAddress .

Requisitos

Requisito Valor
Cliente mínimo com suporte Windows Build 22000
Servidor mínimo com suporte Windows Server 2022
Cabeçalho Nenhum
DLL kernelbase.dll
  • Last updated on