Compartilhar via


CWinApp::WriteProfileString

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.

Requisitos

Cabeçalho: afxwin.h

Consulte também

Referência

Classe de CWinApp

Gráfico da hierarquia

CWinApp::GetProfileString

CWinApp::WriteProfileInt

WritePrivateProfileString

CWinApp::SetRegistryKey