Retrieves data from the specified entries belonging to an EXE entry.
Syntax
DWORD WINAPI SdbQueryDataExTagID(
_In_ PDB pdb,
_In_ TAGID tiExe,
_In_opt_ LPCTSTR lpszDataName,
_Out_opt_ LPDWORD lpdwDataType,
_Out_ LPVOID lpBuffer,
_Inout_opt_ LPDWORD lpcbBufferSize,
_Out_ TAGID *ptiData
);
Parameters
pdb [in]
A handle to the shim database.
tiExe [in]
The TAGID of the EXE entry.
lpszDataName [in, optional]
The name of the data entry to be retrieved. To specify multiple entries, separate the names with the backslash character ("\"). If this parameter is NULL, the function attempts to return all data entries.
lpdwDataType [out, optional]
The data type of the returned entries. This parameter can be one of the following values:
REG_BINARY
REG_DWORD
REG_MULTI_SZ
REG_NONE
REG_QWORD
REG_SZ
lpBuffer [out]
The buffer that receives the data. If buffer is not large enough to contain the data, the function fails and returns ERROR_INSUFFICIENT_BUFFER.
lpcbBufferSize [in, out, optional]
The size of the lpBuffer buffer, in bytes.
ptiData [out]
The TAGID of the data entry.
Return value
This function returns one of the following values.
| Return code | Description |
|---|---|
| ERROR_INVALID_PARAMETER | One or more input parameters is incorrect. |
| ERROR_INTERNAL_DB_CORRUPTION | No data entries were found for the EXE entry. |
| ERROR_INSUFFICIENT_BUFFER | The buffer is not large enough to contain the data entries. |
| ERROR_NOT_ENOUGH_MEMORY | The memory allocation failed. |
| ERROR_NOT_FOUND | A data entry with the name lpszDataName was not found. |
| ERROR_SUCCESS | The function completed successfully. |
Requirements
| Requirement | Value |
|---|---|
| Minimum supported client | Windows Vista [desktop apps only] |
| Minimum supported server | Windows Server 2008 [desktop apps only] |
| DLL | Apphelp.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.
