CWinApp::GetProfileBinary

Articolo
02/19/2013

Chiamare la funzione membro per recuperare i dati binari da una voce in una sezione specifica del Registro di sistema dell'applicazione o del file di .INI.

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

Parametri

lpszSection
Punta a una stringa con terminazione null che specifica la sezione che contiene l'elemento.
lpszEntry
Punta a una stringa con terminazione null che contiene la voce a cui appartiene il valore deve essere recuperato.
ppData
Punta a un puntatore che riceverà l'indirizzo di dati.
pBytes
Punta a un UINT che riceverà la dimensione dei dati in byte).

Valore restituito

Diverso da zero se ha esito positivo; in caso contrario 0.

Note

Questa funzione membro non viene rilevata la distinzione tra maiuscole e minuscole, pertanto le stringhe in lpszSection e i parametri lpszEntry possono variare nel caso.

[!NOTA]

GetProfileBinary alloca un buffer e restituisce il relativo indirizzo in *ppData.Il chiamante è responsabile della versione del buffer tramite delete [].

Nota sulla sicurezza
I dati restituiti dalla funzione non sono necessariamente con terminazione null e il chiamante deve eseguire la convalida.Per ulteriori informazioni, vedere Evitare i sovraccarichi del buffer.

Esempio

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

Per un altro esempio, vedere CWinApp::WriteProfileBinary.