CWinApp::GetProfileBinary

Článek
03/04/2013

Volání funkce tohoto člena načíst binární data z položky určené části registru aplikace nebo.Soubor INI.

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

Parametry

lpszSection
Body řetězec zakončený hodnotou null, který určuje oddíl obsahující položky.
lpszEntry
Body zakončený řetězec, který obsahuje položku, jejíž hodnota má být načtena.
ppData
Body na ukazatel, který bude přijímat data na adresu.
pBytes
Body UINT, který bude přijímat velikost dat (v bajtech).

Vrácená hodnota

Nenulová hodnota, pokud je úspěšná. jinak 0.

Poznámky

Tato funkce členů není rozlišovat malá a velká tak řetězců v lpszSection a lpszEntry parametry se mohou lišit v případě.

[!POZNÁMKA]

GetProfileBinary přidělení vyrovnávací paměti a vrátí jeho adresa v *ppData.Volající je zodpovědný za uvolnění vyrovnávací paměti pomocí Odstranit [.

Poznámka k zabezpečení
Dat, kterou vrací tato funkce není nutně NULL ukončena a volající musí provést ověření.Další informace naleznete v tématu Vyhnout způsobí přetečení vyrovnávací paměti.

Příklad

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

Další příklad viz CWinApp::WriteProfileBinary.