Функції для роботи з реєстром

розбирався, недавно, з функціями що дозволяють працювати з реєстром Windows. Знайшов ряд функцій-членів класу CWinApp: SetRegistryKey, GetProfileInt, GetProfileString, WriteProfileInt, WriteProfileString. Якщо комусь цікавий переклад MSDN'овского хелп до цих функцій - то його можна знайти тут.

CWinApp:: SetRegistryKey

void SetRegistryKey (LPCTSTR lpszRegistryKey);

void SetRegistryKey (UINT nIDRegistryKey);

Параметри

lpszRegistryKey

Покажчик на рядок містить ім'я ключа реєстру.

nIDRegistryKey

ID/індекс ключа в реєстрі.

Опис

Примушує додаток зберігати установки в реєстр замість INI файлів. Ця функція встановлює m_pszRegistryKey, яка потім використовується в наступних функціях-членах CWinApp: GetProfileInt, GetProfileString, WriteProfileInt, and WriteProfileString. Якщо ця функція була викликана, список недавно використовуваних файлів (list of most recently-used -- MRU) також зберігається в реєстрі. Ключ реєстру зазвичай є ім'ям компанії. Ключ реєстру має такий вигляд: HKEY_CURRENT_USERSoftware.

CWinApp:: GetProfileInt

UINT GetProfileInt ( LPCTSTR lpszSection, LPCTSTR lpszEntry, int nDefault);

що повертається значення

Якщо функція успішно відпрацювала - ціле значення рядки певного запису. Повертає значення - значення параметра nDefault якщо функція не знайшла записи. Повертає значення - 0, якщо значення яке відповідає заданій записи не ціле.

Ця функція підтримує шістнадцяткову нотацію для значень у. INI файлі. Коли ви отримуєте знакове ціле, ви повинні перевести значення в int.

Параметри

lpszSection

Покажчик на рядок завершену нулем яка визначає секцію, яка містить запис у реєстрі.

lpszEntry

Покажчик на рядок завершену нулем, яка містить запис, значення якої буде повернуто.

nDefault

Визначає значення за замовчуванням для повернення, якщо система не зможе знайти запис. Це значення може бути беззнакові цілим (unsigned) в діапазоні від 0 до 65,535 або знаковим (signed) в діапазоні від -32,768 До 32,767.

Опис

Викликайте цю функцію для отримання цілого значення запису з певної секції з реєстру або. INI файлу.

Записи зберігаються таким чином:

У Windows NT, значення зберігається в ключ реєстру.

У Windows 3.x, значення зберігається в WIN.INI файл.

У Windows 95, значення зберігається в приховану версію WIN.INI файлу.

Ця функція не чутлива до регістру букв, таким чином, рядки в параметрах lpszSection і lpszEntry можуть використовувати букви різного регістра.

CWinApp:: GetProfileString

CString GetProfileString (LPCTSTR lpszSection, LPCTSTR lpszEntry, LPCTSTR lpszDefault = NULL);

що повертається значення

що повертається значення - рядок із.INI файлу програми або lpszDefault якщо рядок не знайдено. Максимальна довжина рядка, який підтримує система, визначена в _MAX_PATH. Якщо lpszDefault одно NULL, повертається значення - порожній рядок.

Параметри

lpszSection

Покажчик на рядок завершену нулем яка визначає секцію яка містить запис у реєстрі.

lpszEntry

Покажчик на рядок завершену нулем, яка містить запис, рядок з якої буде повернута. Це значення не має дорівнювати NULL.

lpszDefault

Покажчик на значення рядка за умовчанням для заданої запису якщо запис не знайдено в ініціалізує (INI) файлі.

Опис

Викликайте цю функцію для отримання рядки пов'язаної з записом в заданій секції реєстру програму або. INI файлу.

Записи зберігаються таким чином:

У Windows NT, значення зберігається в ключ реєстру.

У Windows 3.x, значення зберігається в WIN.INI файл.

У Windows 95, значення зберігається в приховану версію WIN.INI файлу.

Приклад

CString strSection = "Моя секція";

CString strStringItem = "Мій строковий елемент ";

CString strIntItem = "Мій цілий елемент";

CWinApp * pApp = AfxGetApp ();

pApp-> WriteProfileString (strSection, strStringItem, "test ");

CString strValue;

strValue = pApp-> GetProfileString (strSection, strStringItem);

ASSERT (strValue == "test ");

pApp-> WriteProfileInt (strSection, strIntItem, 1234);

int nValue;

nValue = pApp-> GetProfileInt (strSection, strIntItem, 0);

ASSERT (nValue == 1234);

CWinApp:: WriteProfileInt

BOOL WriteProfileInt (LPCTSTR lpszSection, LPCTSTR lpszEntry, int nValue);

що повертається значення

Не 0 у разі вдалого виклику функції, інакше 0.

Параметри

lpszSection

Покажчик на рядок завершену нулем, яка визначає секцію, що містить запис. Якщо секція не знайдена, вона створюється. Назва секції не залежить від регістру; рядок може поєднувати як великі, так і прописні літери.

lpszEntry

Покажчик на рядок завершену нулем, яка містить запис, в яку буде записано значення. Якщо запис не знайдено в заданій секції, вона створюється.

nValue

Містить значення для запису.

Опис

Викликайте цю функцію для запису заданого значення в задану секцію реєстру або. INI файл.

Записи зберігаються таким чином:

У Windows NT, значення зберігається в ключ реєстру.

У Windows 3.x, значення зберігається в WIN.INI файл.

У Windows 95, значення зберігається в приховану версію WIN.INI файлу.

Приклад

CString strSection = "Моя секція";

CString strStringItem = "Мій строковий елемент ";

CString strIntItem = "Мій цілий елемент";

CWinApp * pApp = AfxGetApp ();

pApp-> WriteProfileString (strSection, strStringItem, "test ");

CString strValue;

strValue = pApp-> GetProfileString (strSection, strStringItem);

ASSERT (strValue == "test ");

pApp-> WriteProfileInt (strSection, strIntItem, 1234);

int nValue;

nValue = pApp-> GetProfileInt (strSection, strIntItem, 0);

ASSERT (nValue == 1234);

CWinApp:: WriteProfileString

BOOL WriteProfileString (LPCTSTR lpszSection, LPCTSTR lpszEntry, LPCTSTR lpszValue );

що повертається значення

Не 0 у разі вдалого виклику функції, інакше 0.

Параметри

lpszSection

Покажчик на рядок завершену нулем, яка визначає секцію, що містить запис. Якщо секція не знайдена, вона створюється. Назва секції не залежить від регістру; рядок може поєднувати як великі, так і прописні літери.

lpszEntry

Покажчик на рядок завершену нулем, яка містить запис, в яку буде записано значення. Якщо запис не знайдено в заданій секції, вона створюється.

lpszValue

Покажчик на рядок, призначену для запису. Якщо цей параметр NULL, запис певна параметром lpszEntry видаляється.

Опис

Викликайте цю функцію для запису заданої рядки в задану секцію реєстру або. INI файл.

Записи зберігаються таким чином:

У Windows NT, значення зберігається в ключ реєстру.

У Windows 3.x, значення зберігається в WIN.INI файл.

У Windows 95, значення зберігається в приховану версію WIN.INI файлу.

Приклад

CString strSection = "Моя секція";

CString strStringItem = "Мій строковий елемент ";

CString strIntItem = "Мій цілий елемент";

CWinApp * pApp = AfxGetApp ();

pApp-> WriteProfileString (strSection, strStringItem, "test ");

CString strValue;

strValue = pApp-> GetProfileString (strSection, strStringItem);

ASSERT (strValue == "test ");

pApp-> WriteProfileInt (strSection, strIntItem, 1234);

int nValue;

nValue = pApp-> GetProfileInt (strSection, strIntItem, 0);

ASSERT (nValue == 1234);

Ну от загалом і все. Якщо є які-небудь зауваження і побажання - пишіть - [email protected]

Список літератури

Для підготовки даної роботи були використані матеріали з сайту http://www.realcoding.net/