registry.odl

The code for this article was written for version 1.0 of the Active Template Library (ATL). The cu

        [in, out] DWORD FAR * lpcbData
        );
    [
    usesgetlasterror,
    entry("RegEnumValueA"),
    helpstring("Enumerates the values for an open registry key one at a time, retrieving the name and integer data for each")
	]
    LONG WINAPI RegEnumValueInt(
        [in] HKEY hKey,
        [in] DWORD dwIndex,
        [in, out] LPSTR lpValueName,
        [in, out] DWORD FAR * lpcbValueName,
        [in] DWORD lpReserved,
        [in, out] DWORD FAR * lpType,
        [in, out] DWORD FAR * lpData,
        [in, out] DWORD FAR * lpcbData
        );

    [
    usesgetlasterror,
    entry("RegFlushKey"),
    helpstring("Writes attributes of an open key into the registry"),
    ]
    LONG WINAPI RegFlushKey([in] HKEY hKey);

	/*
    [
    usesgetlasterror,
    entry(""),
    helpstring(""),
    ]
    LONG WINAPI RegGetKeySecurity (
        [in] HKEY hKey,
        [in] SECURITY_INFORMATION SecurityInformation,
        [in] PSECURITY_DESCRIPTOR pSecurityDescriptor,
        [in, out] DWORD FAR * lpcbSecurityDescriptor
        );
	*/

    [
    usesgetlasterror,
    entry("RegLoadKeyA"),
    helpstring("Creates a subkey and stores registration information from a specified file into that subkey"),
    ]
    LONG WINAPI RegLoadKey(
        [in] HKEY   hKey,
        [in] LPCSTR lpSubKey,
        [in] LPCSTR lpFile
        );

    [
    usesgetlasterror,
    entry("RegNotifyChangeKeyValue"),
    helpstring("Indicates when a registry key or any of its subkeys has changed"),
    ]
    LONG WINAPI RegNotifyChangeKeyValue(
        [in] HKEY hKey,
        [in] BOOL bWatchSubtree,
        [in] DWORD dwNotifyFilter,
        [in] HANDLE hEvent,
        [in] BOOL fAsynchronus
        );
	#endif // WIN32

    [
    usesgetlasterror,
    #if WIN32
    entry("RegOpenKeyA"),
    #else
    entry("RegOpenKey"),
    #endif
    helpstring("Opens the specified key"),
    ]
    LONG WINAPI RegOpenKey(
        [in] HKEY hKey,
        [in] LPCSTR lpSubKey,
        [in, out] HKEY FAR * phkResult
        );

    #if WIN32
    [
    usesgetlasterror,
    entry("RegOpenKeyExA"),
    helpstring("Opens the specified key"),
    ]
    LONG WINAPI RegOpenKeyEx(
        [in] HKEY hKey,
        [in] LPCSTR lpSubKey,
        [in] DWORD ulOptions,
        [in] REGSAM samDesired,
        [in, out] HKEY FAR * phkResult
        );
    #endif

    [
    usesgetlasterror,
    entry("RegQueryInfoKeyA"),
    helpstring("Retrieves information about a registry key"),
    ]
    LONG WINAPI RegQueryInfoKey(
        [in] HKEY hKey,
        [in, out] LPSTR lpClass,
        [in, out] DWORD FAR * lpcbClass,
        [in] DWORD lpReserved,
        [in, out] DWORD FAR * lpcSubKeys,
        [in, out] DWORD FAR * lpcbMaxSubKeyLen,
        [in, out] DWORD FAR * lpcbMaxClassLen,
        [in, out] DWORD FAR * lpcValues,
        [in, out] DWORD FAR * lpcbMaxValueNameLen,
        [in, out] DWORD FAR * lpcbMaxValueLen,
        [in, out] DWORD FAR * lpcbSecurityDescriptor,
        [in, out] DWORD FAR * /* PFILETIME */ lpftLastWriteTime
        );

    [
    usesgetlasterror,
    #if WIN32
    entry("RegQueryValueA"),
    #else
    entry("RegQueryValue"),
    #endif
    helpstring("Retrieves value associated with u13150named value of a specified registry key"),
    ]
    LONG WINAPI RegQueryValue(
        [in] HKEY hKey,
        [in] LPCSTR lpSubKey,
        [in, out] LPSTR lpValue,
        [in, out] LONG FAR * lpcbValue
        );

    #if WIN32
    [
    usesgetlasterror,
    entry("RegQueryValueExA"),
    helpstring("Retrieves byte array value associated with a named or unnamed value of a specified registry key"),
    ]
    LONG WINAPI RegQueryValueEx([in] HKEY hKey,
                                [in] LPCSTR lpValueName,
                                [in] DWORD lpReserved,
                                [in] DWORD FAR * lpType,
                                [in] DWORD lpData,
                                [in, out] DWORD FAR * lpcbData);

    [
    usesgetlasterror,
    entry("RegQueryValueExA"),
    helpstring("Retrieves byte array value associated with a named or unnamed value of a specified registry key"),
    ]
    LONG WINAPI RegQueryValueExByte([in] HKEY hKey,
                                    [in] LPCSTR lpValueName,
                                    [in] DWORD lpReserved,
                                    [in] DWORD FAR * lpType,
                                    [in, out] BYTE FAR * lpData,
                                    [in, out] DWORD FAR * lpcbData);

    [
    usesgetlasterror,
    entry("RegQueryValueExA"),
    helpstring("Retrieves byte array value associated with a named or unnamed value of a specified registry key"),
    ]
    LONG WINAPI RegQueryValueExStr([in] HKEY hKey,
                                   [in] LPCSTR lpValueName,
                                   [in] DWORD lpReserved,
                                   [in] DWORD FAR * lpType,
                                   [in, out] LPSTR lpData,
                                   [in, out] DWORD FAR * lpcbData);

    [
    usesgetlasterror,
    entry("RegQueryValueExA"),
    helpstring("Retrieves Long value associated with a named or unnamed value of a specified registry key"),
    ]
    LONG WINAPI RegQueryValueExInt([in] HKEY hKey,
                                   [in] LPCSTR lpValueName,
                                   [in] DWORD lpReserved,
                                   [in] DWORD FAR * lpType,
                                   [in, out] DWORD FAR * lpData,
                                   [in, out] DWORD FAR * lpcbData);

    // Win95 only
	/*
    [
    usesgetlasterror,
    entry("RegQueryMultipleValuesA"),
    helpstring(""),
    ]
    LONG WINAPI RegQueryMultipleValues(
        [in] HKEY hKey,
        [in, out] PVALENTA val_list,
        [in] DWORD num_vals,
        [in, out] LPSTR lpValueBuf,
        [in, out] DWORD FAR * ldwTotsize
        );
	*/

    [
    usesgetlasterror,
    entry("RegReplaceKeyA"),
    helpstring("Replaces the file backing a key and all its subkeys with another file, so that when the system is next started, the key and subkeys will have the values stored in the new file"),
    ]
    LONG WINAPI RegReplaceKey(
        [in] HKEY    hKey,
        [in] LPCSTR lpSubKey,
        [in] LPCSTR lpNewFile,
        [in] LPCSTR lpOldFile
        );

    [
    usesgetlasterror,
    entry("RegSaveKeyA"),
    helpstring("Reads registry information in a file and copies it over a key in the form of a key and multiple levels of subkeys"),
    ]
    LONG WINAPI RegRestoreKey(
        [in] HKEY hKey,
        [in] LPCSTR lpFile,
        [in] DWORD  dwFlags
        );

    [
    usesgetlasterror,
    entry("RegSaveKeyA"),
    helpstring("Saves a key and all of its subkeys and values to a file"),
    ]
    LONG WINAPI RegSaveKey(
        [in] HKEY hKey,
        [in] LPCSTR lpFile,
        [in] LPSECURITY_ATTRIBUTES lpSecurityAttributes
        );

    [
    usesgetlasterror,
    entry("RegSetKeySecurity"),
    helpstring("Sets the security of an open registry key"),
    ]
    LONG WINAPI RegSetKeySecurity(
        [in] HKEY hKey,
        [in] DWORD /* SECURITY_INFORMATION */ SecurityInformation,
        [in] DWORD /* PSECURITY_DESCRIPTOR */ pSecurityDescriptor
        );
    #endif // WIN32

    [
    usesgetlasterror,
    #if WIN32
    entry("RegSetValueA"),
    #else
    entry("RegSetValue"),
    #endif
    helpstring("Associates a text value with specified key"),
    ]
    LONG WINAPI RegSetValue(
        [in] HKEY hKey,
        [in] LPCSTR lpSubKey,
        [in] DWORD dwType,
        [in] LPCSTR lpData,
        [in] DWORD cbData
        );

    #if WIN32
    [
    usesgetlasterror,
    entry("RegSetValueExA"),
    helpstring("Associates a value (optionally named) with specified key"),
    ]
    LONG WINAPI RegSetValueEx(
        [in] HKEY hKey,
        [in] LPCSTR lpValueName,
        [in] DWORD Reserved,
        [in] DWORD dwType,
        [in] BYTE FAR * lpData,
        [in] DWORD cbData
        );

    [
    usesgetlasterror,
    entry("RegSetValueExA"),
    helpstring("Associates a value (optionally named) with specified key"),
    ]
    LONG
    WINAPI
    RegSetValueExByte(
        [in] HKEY hKey,
        [in] LPCSTR lpValueName,
        [in] DWORD Reserved,
        [in] DWORD dwType,
        [in] BYTE FAR * lpData,
        [in] DWORD cbData
        );

    [
    usesgetlasterror,
    entry("RegSetValueExA"),
    helpstring("Associates a value (optionally named) with specified key"),
    ]
    LONG
    WINAPI
    RegSetValueExStr(
        [in] HKEY hKey,
        [in] LPCSTR lpValueName,
        [in] DWORD Reserved,
        [in] DWORD dwType,
        [in] LPSTR lpData,
        [in] DWORD cbData
        );

    [
    usesgetlasterror,
    entry("RegSetValueExA"),
    helpstring("Associates a value (optionally named) with specified key"),
    ]
    LONG WINAPI RegSetValueExInt(
        [in] HKEY hKey,
        [in] LPCSTR lpValueName,
        [in] DWORD Reserved,
        [in] DWORD dwType,
        [in] DWORD FAR * lpData,
        [in] DWORD cbData
        );

    [
    usesgetlasterror,
    entry("RegUnLoadKeyA"),
    helpstring("Unloads the specified key and subkeys from the registry"),
    ]
    LONG WINAPI RegUnLoadKey(
        [in] HKEY   hKey,
        [in] LPCSTR lpSubKey
        );

    /*
    // Remoteable System Shutdown APIs
    [
    usesgetlasterror,
    entry("InitiateSystemShutdownA"),
    helpstring(""),
    ]
    BOOL WINAPI InitiateSystemShutdown(
        [in, out] LPSTR lpMachineName,
        [in, out] LPSTR lpMessage,
        [in] DWORD dwTimeout,
        [in] BOOL bForceAppsClosed,
        [in] BOOL bRebootAfterShutdown
        );

    [
    usesgetlasterror,
    entry("AbortSystemShutdownA"),
    helpstring(""),
    ]
    BOOL WINAPI AbortSystemShutdown(
        [in, out] LPSTR lpMachineName
        );
    */
    #endif // WIN32

}