Returns an existing test handle that was created with TestCreate.
Syntax
HANDLE TestOpen(
unsigned int testCaseId,
unsigned int options,
unsigned char storage,
GUID* testId,
_Out_ TestInfo* result);
Parameters
testCaseId
The test identifier.
options
The test retrieval options. This parameter can be set to the following values.
| Value | Description |
|---|---|
| 0 | Default option. |
| 1 | Optimize retrieval with locking, like subsequently calling TestQueryData. |
| 2 | Deprecated, this is the same as default option. |
| 131072 | Indicates that additional “properties” field will be included in the returned TestInfo structure. |
storage
The test storage options. This parameter can be set to the following values.
| Value | Description |
|---|---|
| 1 | Data will be stored in process. |
| 2 | Data will be stored out of process. |
testId
The identifier of the test instance.
result [out]
A TestInfo structure containing information about the test.
Return value
The test handle.
Remarks
This function has no associated import library or header file; it must be invoked using the LoadLibrary and GetProcAddress functions.
Requirements
| Requirement | Value |
|---|---|
| Minimum supported client | Windows Build 22000 |
| Minimum supported server | Windows Server 2022 |
| Header | None |
| DLL | kernelbase.dll |
Source: Microsoft Learn / Windows Win32 documentation by Microsoft and contributors. Documentation licensed CC BY 4.0. Code samples are covered by the MIT License. Converted from Markdown, with links normalized and embedded media omitted.
