CWinApp::WriteProfileString

Artigo
02/25/2013

Chamar essa função de membro para gravar a cadeia de caracteres especificada na seção especificada do Registro ou do arquivo .ini do aplicativo.

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

Parâmetros

lpszSection
Aponta para uma cadeia de caracteres NULL- finalizada que especifica a seção que contém a entrada.Se a seção não existir, será criada.O nome da seção é não diferenciando maiúsculas e minúsculas; a cadeia de caracteres pode ser qualquer combinação de e maiúsculas de minúsculas.
lpszEntry
Aponta para uma cadeia de caracteres NULL- finalizada que contém a entrada em que o valor deve ser gravado.Se a entrada não existir, na seção especificada é criada.Se esse parâmetro é NULL, a seção especificada por lpszSection será excluída.
lpszValue
Pontos a cadeia de caracteres a ser gravado.Se esse parâmetro é NULL, a entrada especificado pelo parâmetro de lpszEntry será excluída.

Valor de retorno

Diferente de zero se com êxito; se não 0.

Exemplo

CWinApp* pApp = AfxGetApp();

CString strSection       = _T("My Section");
CString strStringItem    = _T("My String Item");
CString strIntItem       = _T("My Int Item");

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

CString strValue;
strValue = pApp->GetProfileString(strSection, strStringItem);
ASSERT(strValue == _T("test"));

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

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

Para um exemplo, consulte o exemplo para CWinApp::GetProfileInt.