CWinApp::GetProfileString

Artigo
06/10/2015

Chamar essa função de membro para recuperar a cadeia de caracteres associada a uma entrada na seção especificada no Registro ou no arquivo .ini do aplicativo.

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

Parâmetros

lpszSection
Aponta para uma cadeia de caracteres NULL- finalizada que especifica a seção que contém a entrada.
lpszEntry
Aponta para uma cadeia de caracteres NULL- finalizada que contém a entrada cuja cadeia de caracteres deve ser recuperada. Esse valor não deve ser NULO.
lpszDefault
Aponta para o valor da cadeia de caracteres padrão para a entrada dada se a entrada não pode ser encontrada no arquivo de inicialização.

Valor de retorno

O valor de retorno é a cadeia de caracteres de arquivo .ini ou de lpszDefault de aplicativo se a cadeia de caracteres não pode ser encontrada. O comprimento máximo de cadeia de caracteres é suportado pela estrutura _MAX_PATH. Se lpszDefault é NULO, o valor de retorno é uma cadeia de caracteres vazia.

Comentários

Observação de segurança
Os dados retornados por essa função não são necessariamente encerrado NULO, e o chamador deve executar a validação.Para obter mais informações, consulte Evitando estouros 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);

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