SdbGetMatchingExe function

Searches for the specified executable.

Syntax

BOOL WINAPI SdbGetMatchingExe(
  _In_opt_ HSDB            hSDB,
  _In_     LPCTSTR         szPath,
  _In_opt_ LPCTSTR         szModuleName,
  _In_opt_ LPCTSTR         pszEnvironment,
  _In_     DWORD           dwFlags,
  _Out_    PSDBQUERYRESULT pQueryResult
);

Parameters

hSDB [in, optional]

A handle to the shim database returned by the SdbInitDatabase function.

szPath [in]

The path of the executable.

szModuleName [in, optional]

The module name.

pszEnvironment [in, optional]

The environment variables to be used as search context.

dwFlags [in]

This parameter can be 0 or SDBGMEF_IGNORE_ENVIRONMENT (0x1).

pQueryResult [out]

An SDBQUERYRESULT structure. If no match is found, the structure contains TAGREF_NULL.

Return value

The function returns TRUE on success or FALSE on failure.

Remarks

When you have finished with the returned TAGREF, free it using the SdbReleaseMatchingExe function.

Requirements

Requirement Value
Minimum supported client
Windows Vista [desktop apps only]
Minimum supported server
Windows Server 2008 [desktop apps only]
DLL
Apphelp.dll

See also

SdbInitDatabase

SdbReleaseMatchingExe