SdbQueryDataExTagID function

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