CWinApp::GetProfileInt

Artigo
02/25/2013

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.Esse valor pode ser um valor sem sinal no intervalo de 0 a 65.535 ou um valor assinado no intervalo – 32.768 a 32.767.

Valor de retorno

O valor inteiro de cadeia de caracteres após 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 nas definições de lpszSection e de lpszEntry podem diferir o caso de.

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();

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.