CWinApp::GetProfileString

Artigo
08/25/2010

Chame essa função de membro para recuperar a seqüência associada a uma entrada na seção especificada no registro ou o arquivo .ini do aplicativo.

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

Parâmetros

lpszSection
Aponta para uma seqüência de caracteres terminada com nulo que especifica a seção que contém a entrada.
lpszEntry
Aponta para uma seqüência de caracteres terminada com nulo que contém a entrada está cuja seqüência de caracteres a serem recuperados.Este valor não deve ser NULO.
lpszDefault
Aponta para o valor de seqüência de caracteres padrão para a entrada determinado se a entrada não puder ser encontrada no arquivo de inicialização.

Valor de retorno

O valor retornado é a seqüência de caracteres do arquivo .ini do aplicativo ou de lpszDefault Se não for possível encontrar a seqüência de caracteres. O comprimento máximo da seqüência de caracteres com suporte a estrutura é _MAX_PATH. If lpszDefault é NULO, o valor retornado é uma seqüência de caracteres vazia.

Comentários

Observação de segurança:
Os dados retornados por essa função não são necessariamente nulo finalizado e o chamador deve executar a validação.Para obter mais informações, consulte Evitar saturações de buffer.

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.