CWinApp::WriteProfileString

Artigo
08/25/2010

telefonar Essa função de membro para gravar a seqüência de caracteres especificada na seção de registro ou arquivo de inicialização do aplicativo especificada.

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

Parâmetros

lpszSection
Aponta para uma seqüência de caracteres terminada com nulo que especifica a seção que contém a entrada.Se a seção não existir, ele será criado.O nome da seção é o caso independente; a seqüência de caracteres pode ser qualquer combinação de letras maiúsculas e em minúsculas.
lpszEntry
Aponta para uma seqüência de caracteres terminada com nulo que contém a entrada no qual o valor está a ser gravado.Se a entrada não existe na seção especificada, ela é criada.Se esse parâmetro for NULL, a seção especificada pelo lpszSection é excluído.
lpszValue
Aponta para a seqüência de caracteres a ser gravado.Se esse parâmetro for NULL, a entrada especificada pela lpszEntry parâmetro é excluído.

Valor de retorno

Diferente de zero se bem-sucedida; caso contrário, 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);

Outro exemplo, consulte o exemplo para CWinApp::GetProfileInt.