PX_Blob
Wywołać tę funkcję w ramach swojej sterowania DoPropExchange funkcji składowej do serializacji lub zainicjować właściwość, która przechowuje dane dużego obiektu binarnego (BLOB).
BOOL PX_Blob(
CPropExchange* pPX,
LPCTSTR pszPropName,
HGLOBAL& hBlob,
HGLOBAL hBlobDefault = NULL
);
Parametry
pPX
Wskaźnik do CPropExchange obiektu (zwykle przekazywana jako parametr DoPropExchange).pszPropName
Nazwa właściwości poddawanym wymianie.hBlob
Odwołanie do zmiennej, której właściwość jest przechowywany (zazwyczaj zmienną klasy).hBlobDefault
Wartość domyślna dla właściwości.
Wartość zwracana
Różna od zera, jeśli wymiana zakończyła się pomyślnie; 0, w przypadku niepowodzenia.
Uwagi
Wartość właściwości będzie czytać lub zapisywany do zmiennej odwołuje się hBlob, odpowiednio.Ta zmienna powinna zostać zainicjowana do wartości NULL przed wywołaniem początkowo PX_Blob po raz pierwszy (zazwyczaj, to można zrobić w Konstruktorze formantu).Jeśli hBlobDefault jest określony, będzie on używany jako wartość domyślną właściwości.Ta wartość jest używana, jeśli z jakiegokolwiek powodu niepowodzenia procesu inicjowania lub serializacji formantu.
Uchwyty hBlob i hBlobDefault odnoszą się do bloku pamięci, która zawiera następujące:
A DWORD który zawiera długość w bajtach, dane binarne, który następuje, a następnie natychmiast przez
Blok pamięci zawierających rzeczywiste dane binarne.
Należy zauważyć, że PX_Blob przyzna pamięci przy użyciu okna GlobalAlloc interfejsu API, podczas ładowania właściwości typu BLOB.Jesteś odpowiedzialny za zwolnienie tej pamięci.W związku z tym, należy wywołać destruktora kontrolki globalny na temat dowolnej właściwości typu BLOB dojścia aby zwolnić się wszelkie pamięć przydzielona dla pilota.
Wymagania
Nagłówek: afxctl.h