CWinApp::GetProfileBinary

Artigo
08/25/2010

telefonar Essa função de membro para recuperar dados binário a partir de uma entrada dentro de uma seção do registro do aplicativo ou arquivo .ini especificada.

BOOL GetProfileBinary(
   LPCTSTR lpszSection,
   LPCTSTR lpszEntry,
   LPBYTE* ppData,
   UINT* pBytes 
);

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.
ppData
Aponta para um ponteiro que receberá o endereço de dados.
pBytes
Aponta para um UINT que receberá o dimensionar dos dados (em bytes).

Valor de retorno

Diferente de zero se bem-sucedida; caso contrário, 0.

Comentários

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

Observação:
GetProfileBinary aloca um buffer e retorna seu endereço em *ppData.O chamador é responsável pela liberação de buffer usando Excluir.

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");
struct complex {
  double re, im;
} myData = { 1.4142, -0.5 };

// Write the information to the registry.

pApp->WriteProfileBinary(pszKey, _T("ComplexData"), (LPBYTE)&myData, 
   sizeof(myData));

// Read the information from the registry.

complex* pData;
UINT n;
BOOL ret = pApp->GetProfileBinary(pszKey, _T("ComplexData"), (LPBYTE*)&pData, 
   &n);

ASSERT(ret);
ASSERT(n == sizeof(complex));
ASSERT(myData.re == pData->re);
ASSERT(myData.im == pData->im);
delete [] pData; // free the buffer

Para obter um exemplo adicional, consulte CWinApp::WriteProfileBinary.