CWinApp::GetProfileString

Artigo
02/25/2013

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.