CWinApp::GetProfileInt

Artigo
08/25/2010

Chame essa função de membro para recuperar o valor de um inteiro de uma entrada dentro de uma seção do registro do aplicativo ou arquivo .ini especificada.

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

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 cujo valor é a serem recuperados.
nDefault
Especifica o valor padrão para retornar se a estrutura não é possível encontrar a entrada.Esse valor pode ser um valor não assinado no intervalo de 0 a 65.535 ou um valor assinado de – 32.768 intervalo, 768 até 32.767.

Valor de retorno

O valor inteiro da seqüência de caracteres que segue a entrada especificada se a função for bem-sucedida.O valor retornado é o valor de nDefault Se a função não encontrar a entrada do parâmetro. O valor retornado é 0 se o valor correspondente à entrada especificada não for um inteiro.

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

Comentários

Esta função de membro não está diferenciação de maiúsculas, assim, as seqüências de caracteres no lpszSection e lpszEntry parâmetros podem ser diferentes no caso.

Observação de segurança:
Os dados retornados por essa função não são necessariamente NULL finalizado, e o chamador deve executar a validação.Para obter mais informações, consulte Evitar 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 obter um exemplo adicional, consulte CWinApp::WriteProfileInt.