apphelp.c File Reference

#include "windef.h"
#include "winbase.h"
#include "winreg.h"
#include "strsafe.h"
#include "apphelp.h"
#include <ndk/rtlfuncs.h>
#include <ndk/cmfuncs.h>
#include <ndk/obfuncs.h>
#include <ndk/kdtypes.h>

Include dependency graph for apphelp.c:

Go to the source code of this file.

Macros
#define	WIN32_NO_STATUS
#define	DPFLTR_APPCOMPAT_ID   123
#define	MAX_GUID_STRING_LEN   sizeof("{12345678-1234-1234-0123-456789abcdef}")
#define	NT_SUCCESS(StatCode)   ((NTSTATUS)(StatCode) >= 0)
#define	APPHELP_DONTWRITE_REASON   2
#define	APPHELP_CLEARBITS   0x100 /* TODO: Investigate */
#define	APPHELP_IGNORE_ENVIRONMENT   0x400
#define	APPHELP_VALID_RESULT   0x10000
#define	APPHELP_RESULT_NOTFOUND   0x20000
#define	APPHELP_RESULT_FOUND   0x40000

Functions
ACCESS_MASK	Wow64QueryFlag (void)
void	ApphelppInitDebugLevel (void)
BOOL WINAPI	DllMain (HINSTANCE hinst, DWORD reason, LPVOID reserved)
BOOL WINAPI	ApphelpCheckInstallShieldPackage (void *ptr, LPCWSTR path)
BOOL WINAPI	ApphelpCheckShellObject (REFCLSID ObjectCLSID, BOOL bShimIfNecessary, ULONGLONG *pullFlags)
BOOL WINAPIV	ShimDbgPrint (SHIM_LOG_LEVEL Level, PCSTR FunctionName, PCSTR Format,...)
BOOL WINAPI	ApphelpCheckRunAppEx (_In_ HANDLE FileHandle, _In_opt_ PVOID Unk1, _In_opt_ PVOID Unk2, _In_opt_z_ PCWSTR ApplicationName, _In_opt_ PVOID Environment, _In_opt_ USHORT ExeType, _Inout_opt_ PULONG Reason, _Out_opt_ PVOID *SdbQueryAppCompatData, _Out_opt_ PULONG SdbQueryAppCompatDataSize, _Out_opt_ PVOID *SxsData, _Out_opt_ PULONG SxsDataSize, _Out_opt_ PULONG FusionFlags, _Out_opt_ PULONG64 SomeFlag1, _Out_opt_ PULONG SomeFlag2)
SdbRegisterDatabaseEx
Register an application compatibility database Parameters pszDatabasePath The database. Required dwDatabaseType The database type. SDB_DATABASE_* pTimeStamp The timestamp. When this argument is not provided, the system time is used. Returns TRUE on success, or FALSE on failure.
BOOL WINAPI	SdbRegisterDatabaseEx (_In_ LPCWSTR pszDatabasePath, _In_ DWORD dwDatabaseType, _In_opt_ const PULONGLONG pTimeStamp)
SdbRegisterDatabase
Register an application compatibility database Parameters pszDatabasePath The database. Required dwDatabaseType The database type. SDB_DATABASE_* Returns TRUE on success, or FALSE on failure.
BOOL WINAPI	SdbRegisterDatabase (_In_ LPCWSTR pszDatabasePath, _In_ DWORD dwDatabaseType)
SdbUnregisterDatabase
Parameters pguidDB Returns
BOOL WINAPI	SdbUnregisterDatabase (_In_ const GUID *pguidDB)
BOOL WINAPI	BaseDumpAppcompatCache (VOID)
BOOL WINAPI	BaseFlushAppcompatCache (VOID)
ShimDumpCache
Dump contents of the shim cache. Parameters hwnd Unused, pass 0 hInstance Unused, pass 0 lpszCmdLine Unused, pass 0 nCmdShow Unused, pass 0 Returns
BOOL WINAPI	ShimDumpCache (HWND hwnd, HINSTANCE hInstance, LPCSTR lpszCmdLine, int nCmdShow)
ShimFlushCache
Flush the shim cache. Call this after installing a new shim database Parameters hwnd Unused, pass 0 hInstance Unused, pass 0 lpszCmdLine Unused, pass 0 nCmdShow Unused, pass 0 Returns
BOOL WINAPI	ShimFlushCache (HWND hwnd, HINSTANCE hInstance, LPCSTR lpszCmdLine, int nCmdShow)

Variables
const UNICODE_STRING	InstalledSDBKeyName = RTL_CONSTANT_STRING(L"\\Registry\\Machine\\Software\\Microsoft\\Windows NT\\CurrentVersion\\AppCompatFlags\\InstalledSDB")
ULONG	g_ShimDebugLevel = ~0
HMODULE	g_hInstance

Macro Definition Documentation

APPHELP_CLEARBITS

#define APPHELP_CLEARBITS   0x100 /* TODO: Investigate */

Definition at line 155 of file apphelp.c.

APPHELP_DONTWRITE_REASON

#define APPHELP_DONTWRITE_REASON   2

Definition at line 154 of file apphelp.c.

APPHELP_IGNORE_ENVIRONMENT

#define APPHELP_IGNORE_ENVIRONMENT   0x400

Definition at line 156 of file apphelp.c.

APPHELP_RESULT_FOUND

#define APPHELP_RESULT_FOUND   0x40000

Definition at line 160 of file apphelp.c.

APPHELP_RESULT_NOTFOUND

#define APPHELP_RESULT_NOTFOUND   0x20000

Definition at line 159 of file apphelp.c.

APPHELP_VALID_RESULT

#define APPHELP_VALID_RESULT   0x10000

Definition at line 158 of file apphelp.c.

DPFLTR_APPCOMPAT_ID

#define DPFLTR_APPCOMPAT_ID   123

Definition at line 27 of file apphelp.c.

MAX_GUID_STRING_LEN

#define MAX_GUID_STRING_LEN   sizeof("{12345678-1234-1234-0123-456789abcdef}")

Definition at line 29 of file apphelp.c.

NT_SUCCESS

#define NT_SUCCESS

(

StatCode

)

((NTSTATUS)(StatCode) >= 0)

Definition at line 32 of file apphelp.c.

WIN32_NO_STATUS

#define WIN32_NO_STATUS

Definition at line 10 of file apphelp.c.

Function Documentation

ApphelpCheckInstallShieldPackage()

BOOL WINAPI ApphelpCheckInstallShieldPackage	(	void *	ptr,
		LPCWSTR	path
	)

Definition at line 75 of file apphelp.c.

{
    SHIM_WARN("stub: ptr=%p, path='%S'\n", ptr, path);
    return TRUE;
}

ApphelpCheckRunAppEx()

BOOL WINAPI ApphelpCheckRunAppEx	(	_In_ HANDLE	FileHandle,
		_In_opt_ PVOID	Unk1,
		_In_opt_ PVOID	Unk2,
		_In_opt_z_ PCWSTR	ApplicationName,
		_In_opt_ PVOID	Environment,
		_In_opt_ USHORT	ExeType,
		_Inout_opt_ PULONG	Reason,
		_Out_opt_ PVOID *	SdbQueryAppCompatData,
		_Out_opt_ PULONG	SdbQueryAppCompatDataSize,
		_Out_opt_ PVOID *	SxsData,
		_Out_opt_ PULONG	SxsDataSize,
		_Out_opt_ PULONG	FusionFlags,
		_Out_opt_ PULONG64	SomeFlag1,
		_Out_opt_ PULONG	SomeFlag2
	)

Lookup Shims / Fixes for the specified application

Parameters

[in]	FileHandle	Handle to the file to check.
[in]	Unk1
[in]	Unk2
[in]	ApplicationName	Exe to check
[in]	Environment	The environment variables to use, or NULL to use the current environment.
[in]	ExeType	Exe type (MACHINE_TYPE_XXXX)
[in,out]	Reason	Input/output flags
[in]	SdbQueryAppCompatData	The resulting data.
[in]	SdbQueryAppCompatDataSize	The resulting data size.
[in]	SxsData	TODO
[in]	SxsDataSize	TODO
[in]	FusionFlags	TODO
[in]	SomeFlag1	TODO
[in]	SomeFlag2	TODO

Returns

TRUE if the application is allowed to run.

Definition at line 184 of file apphelp.c.

{
    SDBQUERYRESULT* result = NULL;
    HSDB hsdb = NULL;
    DWORD dwFlags = 0;
 
    if (SxsData)
        *SxsData = NULL;
    if (SxsDataSize)
        *SxsDataSize = 0;
    if (FusionFlags)
        *FusionFlags = 0;
    if (SomeFlag1)
        *SomeFlag1 = 0;
    if (SomeFlag2)
        *SomeFlag2 = 0;
    if (Reason)
        dwFlags = *Reason;
 
    dwFlags &= ~APPHELP_CLEARBITS;
 
    *SdbQueryAppCompatData = result = RtlAllocateHeap(RtlGetProcessHeap(), HEAP_ZERO_MEMORY, sizeof(SDBQUERYRESULT));
    if (SdbQueryAppCompatDataSize)
        *SdbQueryAppCompatDataSize = sizeof(*result);
 
 
    hsdb = SdbInitDatabase(HID_DOS_PATHS | SDB_DATABASE_MAIN_SHIM, NULL);
    if (hsdb)
    {
        BOOL FoundMatch;
        DWORD MatchingExeFlags = 0;
 
        if (dwFlags & APPHELP_IGNORE_ENVIRONMENT)
            MatchingExeFlags |= SDBGMEF_IGNORE_ENVIRONMENT;
 
        FoundMatch = SdbGetMatchingExe(hsdb, ApplicationName, NULL, Environment, MatchingExeFlags, result);
        if (FileHandle != INVALID_HANDLE_VALUE)
        {
            dwFlags |= APPHELP_VALID_RESULT;
            dwFlags |= (FoundMatch ? APPHELP_RESULT_FOUND : APPHELP_RESULT_NOTFOUND);
        }
 
        SdbReleaseDatabase(hsdb);
    }
 
    if (Reason && !(dwFlags & APPHELP_DONTWRITE_REASON))
        *Reason = dwFlags;
 
 
    /* We should _ALWAYS_ return TRUE here, unless we want to block an application from starting! */
    return TRUE;
}

ApphelpCheckShellObject()

BOOL WINAPI ApphelpCheckShellObject	(	REFCLSID	ObjectCLSID,
		BOOL	bShimIfNecessary,
		ULONGLONG *	pullFlags
	)

Definition at line 82 of file apphelp.c.

{
    WCHAR GuidString[MAX_GUID_STRING_LEN];
    if (!ObjectCLSID || !SdbGUIDToString(ObjectCLSID, GuidString, RTL_NUMBER_OF(GuidString)))
        GuidString[0] = L'\0';
    SHIM_WARN("stub: ObjectCLSID='%S', bShimIfNecessary=%d, pullFlags=%p)\n", GuidString, bShimIfNecessary, pullFlags);
 
    if (pullFlags)
        *pullFlags = 0;
 
    return TRUE;
}

Referenced by START_TEST().

ApphelppInitDebugLevel()

void ApphelppInitDebugLevel

(

void

)

Definition at line 38 of file apphelp.c.

{
    static const UNICODE_STRING DebugKey = RTL_CONSTANT_STRING(L"SHIM_DEBUG_LEVEL");
    UNICODE_STRING DebugValue;
    NTSTATUS Status;
    ULONG NewLevel = SHIM_ERR;
    WCHAR Buffer[40];
 
    RtlInitEmptyUnicodeString(&DebugValue, Buffer, sizeof(Buffer));
 
    Status = RtlQueryEnvironmentVariable_U(NULL, &DebugKey, &DebugValue);
 
    if (NT_SUCCESS(Status))
    {
        if (!NT_SUCCESS(RtlUnicodeStringToInteger(&DebugValue, 10, &NewLevel)))
            NewLevel = SHIM_ERR;
    }
    g_ShimDebugLevel = NewLevel;
}

Referenced by ShimDbgPrint().

BaseDumpAppcompatCache()

BOOL WINAPI BaseDumpAppcompatCache

(

VOID

)

Definition at line 316 of file appcache.c.

{
    NTSTATUS Status;
 
    Status = NtApphelpCacheControl(ApphelpCacheServiceDump, NULL);
    return NT_SUCCESS(Status);
}

Referenced by ShimDumpCache().

BaseFlushAppcompatCache()

BOOL WINAPI BaseFlushAppcompatCache

(

VOID

)

Definition at line 329 of file appcache.c.

{
    NTSTATUS Status;
 
    Status = NtApphelpCacheControl(ApphelpCacheServiceFlush, NULL);
    return NT_SUCCESS(Status);
}

Referenced by ShimFlushCache().

DllMain()

BOOL WINAPI DllMain	(	HINSTANCE	hinst,
		DWORD	reason,
		LPVOID	reserved
	)

Definition at line 59 of file apphelp.c.

{
    switch (reason)
    {
    case DLL_PROCESS_ATTACH:
        g_hInstance = hinst;
        DisableThreadLibraryCalls(hinst);
        SdbpHeapInit();
        break;
    case DLL_PROCESS_DETACH:
        SdbpHeapDeinit();
        break;
    }
    return TRUE;
}

SdbRegisterDatabase()

BOOL WINAPI SdbRegisterDatabase	(	_In_ LPCWSTR	pszDatabasePath,
		_In_ DWORD	dwDatabaseType
	)

Definition at line 391 of file apphelp.c.

{
    return SdbRegisterDatabaseEx(pszDatabasePath, dwDatabaseType, NULL);
}

SdbRegisterDatabaseEx()

BOOL WINAPI SdbRegisterDatabaseEx	(	_In_ LPCWSTR	pszDatabasePath,
		_In_ DWORD	dwDatabaseType,
		_In_opt_ const PULONGLONG	pTimeStamp
	)

Definition at line 261 of file apphelp.c.

{
    PDB pdb;
    DB_INFORMATION Information;
    WCHAR GuidBuffer[MAX_GUID_STRING_LEN];
    UNICODE_STRING KeyName;
    ACCESS_MASK KeyAccess;
    OBJECT_ATTRIBUTES ObjectKey = RTL_INIT_OBJECT_ATTRIBUTES(&KeyName, OBJ_CASE_INSENSITIVE);
    NTSTATUS Status;
    HANDLE InstalledSDBKey;
 
    pdb = SdbOpenDatabase(pszDatabasePath, DOS_PATH);
    if (!pdb)
    {
        SHIM_ERR("Unable to open DB %S\n", pszDatabasePath);
        return FALSE;
    }
 
    if (!SdbGetDatabaseInformation(pdb, &Information) ||
        !(Information.dwFlags & DB_INFO_FLAGS_VALID_GUID))
    {
        SHIM_ERR("Unable to retrieve DB info\n");
        SdbCloseDatabase(pdb);
        return FALSE;
    }
 
    if (!SdbGUIDToString(&Information.Id, GuidBuffer, RTL_NUMBER_OF(GuidBuffer)))
    {
        SHIM_ERR("Unable to Convert GUID to string\n");
        SdbFreeDatabaseInformation(&Information);
        SdbCloseDatabase(pdb);
        return FALSE;
    }
 
    KeyName = InstalledSDBKeyName;
    KeyAccess = Wow64QueryFlag() | KEY_WRITE | KEY_QUERY_VALUE | KEY_ENUMERATE_SUB_KEYS;
    Status = NtCreateKey(&InstalledSDBKey, KeyAccess, &ObjectKey, 0, NULL, 0, NULL);
    if (NT_SUCCESS(Status))
    {
        HANDLE DbKey;
 
        RtlInitUnicodeString(&KeyName, GuidBuffer);
        ObjectKey.RootDirectory = InstalledSDBKey;
 
        Status = NtCreateKey(&DbKey, KeyAccess, &ObjectKey, 0, NULL, 0, NULL);
        if (NT_SUCCESS(Status))
        {
            UNICODE_STRING DatabasePathKey = RTL_CONSTANT_STRING(L"DatabasePath");
            UNICODE_STRING DatabaseInstallTimeStampKey = RTL_CONSTANT_STRING(L"DatabaseInstallTimeStamp");
            UNICODE_STRING DatabaseTypeKey = RTL_CONSTANT_STRING(L"DatabaseType");
            UNICODE_STRING DatabaseDescriptionKey = RTL_CONSTANT_STRING(L"DatabaseDescription");
 
            Status = NtSetValueKey(DbKey, &DatabasePathKey, 0, REG_SZ,
                                   (PVOID)pszDatabasePath, ((ULONG)wcslen(pszDatabasePath) + 1) * sizeof(WCHAR));
            if (!NT_SUCCESS(Status))
                SHIM_ERR("Unable to write %wZ\n", &DatabasePathKey);
 
            if (NT_SUCCESS(Status))
            {
                ULARGE_INTEGER ulTimeStamp;
                if (pTimeStamp)
                {
                    ulTimeStamp.QuadPart = *pTimeStamp;
                }
                else
                {
                    FILETIME fi;
                    GetSystemTimeAsFileTime(&fi);
                    ulTimeStamp.LowPart = fi.dwLowDateTime;
                    ulTimeStamp.HighPart = fi.dwHighDateTime;
                }
                Status = NtSetValueKey(DbKey, &DatabaseInstallTimeStampKey, 0, REG_QWORD,
                                       &ulTimeStamp.QuadPart, sizeof(ulTimeStamp));
                if (!NT_SUCCESS(Status))
                    SHIM_ERR("Unable to write %wZ\n", &DatabaseInstallTimeStampKey);
            }
 
            if (NT_SUCCESS(Status))
            {
                Status = NtSetValueKey(DbKey, &DatabaseTypeKey, 0, REG_DWORD,
                                       &dwDatabaseType, sizeof(dwDatabaseType));
                if (!NT_SUCCESS(Status))
                    SHIM_ERR("Unable to write %wZ\n", &DatabaseTypeKey);
            }
 
            if (NT_SUCCESS(Status) && Information.Description)
            {
                Status = NtSetValueKey(DbKey, &DatabaseDescriptionKey, 0, REG_SZ,
                                       (PVOID)Information.Description, ((ULONG)wcslen(Information.Description) + 1) * sizeof(WCHAR));
                if (!NT_SUCCESS(Status))
                    SHIM_ERR("Unable to write %wZ\n", &DatabaseDescriptionKey);
            }
 
            NtClose(DbKey);
 
            if (NT_SUCCESS(Status))
            {
                SHIM_INFO("Installed %wS as %wZ\n", pszDatabasePath, &KeyName);
            }
        }
        else
        {
            SHIM_ERR("Unable to create key %wZ\n", &KeyName);
        }
 
        NtClose(InstalledSDBKey);
    }
    else
    {
        SHIM_ERR("Unable to create key %wZ\n", &KeyName);
    }
 
    SdbFreeDatabaseInformation(&Information);
    SdbCloseDatabase(pdb);
 
    return NT_SUCCESS(Status);
}

Referenced by SdbInstall(), and SdbRegisterDatabase().

SdbUnregisterDatabase()

BOOL WINAPI SdbUnregisterDatabase

(

_In_ const GUID *

pguidDB

)

Definition at line 406 of file apphelp.c.

{
    WCHAR KeyBuffer[MAX_PATH], GuidBuffer[50];
    UNICODE_STRING KeyName;
    ACCESS_MASK KeyAccess;
    OBJECT_ATTRIBUTES ObjectKey = RTL_INIT_OBJECT_ATTRIBUTES(&KeyName, OBJ_CASE_INSENSITIVE);
    NTSTATUS Status;
    HANDLE DbKey;
 
    if (!SdbGUIDToString(pguidDB, GuidBuffer, RTL_NUMBER_OF(GuidBuffer)))
    {
        SHIM_ERR("Unable to Convert GUID to string\n");
        return FALSE;
    }
 
    RtlInitEmptyUnicodeString(&KeyName, KeyBuffer, sizeof(KeyBuffer));
    RtlAppendUnicodeStringToString(&KeyName, &InstalledSDBKeyName);
    RtlAppendUnicodeToString(&KeyName, L"\\");
    RtlAppendUnicodeToString(&KeyName, GuidBuffer);
 
    KeyAccess = Wow64QueryFlag() | DELETE;
    Status = NtCreateKey(&DbKey, KeyAccess, &ObjectKey, 0, NULL, 0, NULL);
    if (!NT_SUCCESS(Status))
    {
        SHIM_ERR("Unable to open %wZ\n", &KeyName);
        return FALSE;
    }
 
    Status = NtDeleteKey(DbKey);
    if (!NT_SUCCESS(Status))
        SHIM_ERR("Unable to delete %wZ\n", &KeyName);
 
    NtClose(DbKey);
    return NT_SUCCESS(Status);
}

Referenced by SdbUninstall().

ShimDbgPrint()

BOOL WINAPIV ShimDbgPrint	(	SHIM_LOG_LEVEL	Level,
		PCSTR	FunctionName,
		PCSTR	Format,
			...
	)

Outputs diagnostic info.

Parameters

[in]	Level	The level to log this message with, choose any of [SHIM_ERR, SHIM_WARN, SHIM_INFO].
[in]	FunctionName	The function this log should be attributed to.
[in]	Format	The format string.
	...	Variable arguments providing additional information.

Returns

Success: TRUE Failure: FALSE.

Definition at line 106 of file apphelp.c.

{
    char Buffer[512];
    va_list ArgList;
    char* Current = Buffer;
    const char* LevelStr;
    size_t Length = sizeof(Buffer);
 
    if (g_ShimDebugLevel == ~0)
        ApphelppInitDebugLevel();
 
    if (Level > g_ShimDebugLevel)
        return FALSE;
 
    switch (Level)
    {
    case SHIM_ERR:
        LevelStr = "Err ";
        Level = DPFLTR_MASK | (1 << DPFLTR_ERROR_LEVEL);
        break;
    case SHIM_WARN:
        LevelStr = "Warn";
        Level = DPFLTR_MASK | (1 << DPFLTR_WARNING_LEVEL);
        break;
    case SHIM_INFO:
        LevelStr = "Info";
        Level = DPFLTR_MASK | (1 << DPFLTR_INFO_LEVEL);
        break;
    default:
        LevelStr = "User";
        Level = DPFLTR_MASK | (1 << DPFLTR_INFO_LEVEL);
        break;
    }
    StringCchPrintfExA(Current, Length, &Current, &Length, STRSAFE_NULL_ON_FAILURE, "[%s][%-20s] ", LevelStr, FunctionName);
 
    va_start(ArgList, Format);
    StringCchVPrintfExA(Current, Length, &Current, &Length, STRSAFE_NULL_ON_FAILURE, Format, ArgList);
    va_end(ArgList);
 
#if defined(APPCOMPAT_USE_DBGPRINTEX) && APPCOMPAT_USE_DBGPRINTEX
    return NT_SUCCESS(DbgPrintEx(DPFLTR_APPCOMPAT_ID, Level, "%s", Buffer));
#else
    DbgPrint("%s", Buffer);
    return TRUE;
#endif
}

ShimDumpCache()

BOOL WINAPI ShimDumpCache	(	HWND	hwnd,
		HINSTANCE	hInstance,
		LPCSTR	lpszCmdLine,
		int	nCmdShow
	)

Definition at line 458 of file apphelp.c.

{
    return BaseDumpAppcompatCache();
}

ShimFlushCache()

BOOL WINAPI ShimFlushCache	(	HWND	hwnd,
		HINSTANCE	hInstance,
		LPCSTR	lpszCmdLine,
		int	nCmdShow
	)

Definition at line 473 of file apphelp.c.

{
    return BaseFlushAppcompatCache();
}

Wow64QueryFlag()

ACCESS_MASK Wow64QueryFlag

(

void

)

Definition at line 179 of file layer.c.

{
    if (g_QueryFlag == 0xffffffff)
    {
        ULONG_PTR wow64_ptr = 0;
        NTSTATUS Status = NtQueryInformationProcess(NtCurrentProcess(), ProcessWow64Information, &wow64_ptr, sizeof(wow64_ptr), NULL);
        g_QueryFlag = (NT_SUCCESS(Status) && wow64_ptr != 0) ? KEY_WOW64_64KEY : 0;
    }
    return g_QueryFlag;
}

Referenced by SdbpOpenKey(), SdbRegisterDatabaseEx(), and SdbUnregisterDatabase().

Variable Documentation

g_hInstance

HMODULE g_hInstance

Definition at line 36 of file apphelp.c.

Referenced by DllMain().

g_ShimDebugLevel

ULONG g_ShimDebugLevel = ~0

Definition at line 35 of file apphelp.c.

Referenced by ApphelppInitDebugLevel(), and ShimDbgPrint().

InstalledSDBKeyName

const UNICODE_STRING InstalledSDBKeyName = RTL_CONSTANT_STRING(L"\\Registry\\Machine\\Software\\Microsoft\\Windows NT\\CurrentVersion\\AppCompatFlags\\InstalledSDB")

Definition at line 24 of file apphelp.c.

Referenced by SdbRegisterDatabaseEx(), and SdbUnregisterDatabase().