CWinApp::GetProfileInt

Artigo
06/10/2015

Chamar essa função de membro para recuperar o valor de um inteiro de uma entrada em uma seção especificada do Registro ou do arquivo .ini do aplicativo.

UINT GetProfileInt( 
   LPCTSTR lpszSection, 
   LPCTSTR lpszEntry, 
   int nDefault  
);

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 cujo valor deve ser recuperado.
nDefault
Especifica o valor padrão para retornar se a estrutura não pode encontrar a entrada.

Valor de retorno

O valor inteiro de cadeia de caracteres que segue a entrada se a função especificada for bem-sucedida. O valor de retorno é o valor do parâmetro de nDefault se a função não encontrar a entrada. O valor de retorno é 0 se o valor correspondente a entrada especificada não é um número inteiro.

Essa função de membro oferece suporte a notação hexadecimal para o valor no arquivo .ini. Quando você recupera um inteiro com sinal, você deve converter o valor em int.

Comentários

Essa função de membro não diferencia maiúsculas de minúsculas, para que as cadeias de caracteres parâmetros de lpszSection e de lpszEntry podem diferir que caso.

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 saturações de buffer.

Exemplo

CWinApp* pApp = AfxGetApp();

const TCHAR* pszKey = _T("My Section"); 
const TCHAR* pszName = _T("Julian");
int iAge = 26;

// Write the information to the registry.

pApp->WriteProfileString(pszKey, _T("Name"), pszName);
pApp->WriteProfileInt(pszKey, _T("Age"), iAge);

// Read the information from the registry.

CString strName = pApp->GetProfileString(pszKey, _T("Name"));
int iAge2 = pApp->GetProfileInt(pszKey, _T("Age"), 0);

ASSERT(strName == pszName);
ASSERT(iAge2 == iAge);

Para um exemplo adicional, consulte CWinApp::WriteProfileInt.