On-line справка по Win32 API

БЕСПЛАТНАЯ ежедневная online лотерея! Выигрывай каждый день БЕСПЛАТНО!

A-B-C-D-E-F-G-H-I-J-K-L-M-N-O-P-Q-R-S-T-U-V-W-X-Y-Z | Скачать

RegReplaceKey

The RegReplaceKey function 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 RegReplaceKey(

HKEY hKey, // handle of open key
LPCTSTR lpSubKey, // address of name of subkey
LPCTSTR lpNewFile, // address of filename for file with new data
LPCTSTR lpOldFile // address of filename for backup file
);

Parameters

hKey

Identifies a currently open key or any of the following predefined reserved handle values:

HKEY_CLASSES_ROOT
HKEY_CURRENT_USER
HKEY_LOCAL_MACHINE
HKEY_USERS

lpSubKey

Points to a null-terminated string containing the name of a key whose subkeys and values are replaced by this function. This key must be a subkey of the key identified by the hKey parameter. This parameter can be NULL.
The selected key must be the root of a hive; that is, it must be an immediate descendent of HKEY_LOCAL_MACHINE or HKEY_USERS.

lpNewFile

Points to a null-terminated string containing the name of the file with registration information. This file is typically created by using the RegSaveKey function. Under the file allocation table (FAT) file system, the filename may not have an extension.

lpOldFile

Points to a null-terminated string containing the name of a file that receives a backup copy of the registry information being replaced. If this file is created under the FAT file system, it should not have an extension.

Return Values

If the function succeeds, the return value is ERROR_SUCCESS.
If the function fails, the return value is a nonzero error code defined in WINERROR.H. You can use the FormatMessage function with the FORMAT_MESSAGE_FROM_SYSTEM flag to get a generic description of the error.

Remarks

The file specified by the lpNewFile parameter remains open until the system is restarted.
If hKey is a handle returned by RegConnectRegistry, then the paths specified in lpNewFile and lpOldFile are relative to the remote computer.
Windows NT: The calling process must have the SE_RESTORE_NAME privilege. For more information about privileges, see Privileges.
Windows 95: Security privileges are not supported or required.

See Also

RegConnectRegistry, RegDeleteKey, RegLoadKey, RegRestoreKey

Пригласи друзей и счет твоего мобильника всегда будет положительным!

Пригласи друзей и счет твоего мобильника всегда будет положительным!

RegReplaceKey

Функция RegReplaceKey заменяет файл, возвращать ключевые и все подключи с другим файлом, так, что когда система затем будет начата, ключ и подключи будут иметь величины сохраненные в новом файле.

ДОЛГО (ДЛИНОЙ) RegReplaceKey(

HKEY hKey, // РУЧКА открытой клавиши LPCTSTR lpSubKey, // адреса имени подключа LPCTSTR lpNewFile, // адреса filename для файла с новым адресом данных LPCTSTR lpOldFile // filename для резервного файла
);

Параметры

hKey

Идентифицирует к настоящему времени открытую клавишу или любая из следующей встроенной резервной ручки оценивает:

HKEY_CLASSES_ROOT HKEY_CURRENT_USER HKEY_LOCAL_MACHINE HKEY_USERS

lpSubKey

Точки на недействительный расторгнутую строку, содержащие имя клавиши, чьи подключи и величины заменены этой функцией. Эта клавиша должна быть подключом клавиши идентифицированной параметром hKey. Этот параметр может быть НЕДЕЙСТВИТЕЛЕН.
Выбранная клавиша должна быть корнем улья; то есть, это должно быть безотлагательный descendent HKEY_LOCAL_MACHINE или HKEY_USERS.

lpNewFile

Точки на недействительный расторгнутую строку, содержащие имя файла с регистрационной информацией. Этот файл обычно создан использованием функции RegSaveKey. Под файловой таблицей распределения (ЖИРА) файловая система, filename не мочь иметь расширение.

lpOldFile

Точки на недействительный расторгнутую строку, содержащие имя файла, который получает резервную копию информации регистрации, заменянной. Если этот файл создан под файловой системой ЖИРА, он не должен иметь расширение.

Обратные Величины

Если функция добивается успеха, обратная величина - ERROR_SUCCESS.
Если функция терпит неудачу, обратная величина является ненулевым кодом ошибки определенным в WINERROR.H. Вы можете использовать функцию FormatMessage с флагом FORMAT_MESSAGE_FROM_SYSTEM, чтобы получать общее описание ошибки.

Замечания

Файл определенный параметром lpNewFile остается открытым пока система не будет перезапущена.
Если hKey - ручка возвращанная RegConnectRegistry, тогда пути определялись в lpNewFile и lpOldFile - относительно дистанционного компьютера.
Windows NT: вызов процесса должен иметь привилегию SE_RESTORE_NAME. Более подробно о привилегиях, смотри Привилегии.
Windows 95: привилегии Безопасности не поддерживаны или потребовались.

Смотри Также

RegConnectRegistry, RegDeleteKey, RegLoadKey, RegRestoreKey

Используются технологии uCoz