PX_Blob
Wywołanie tej funkcji w ramach programu kontroli DoPropExchange Członkowskich funkcji 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, aby CPropExchange obiektu (zwykle przekazywana jako parametr DoPropExchange).pszPropName
Nazwa właściwości poddawanym wymianie.hBlob
Odwołanie do zmiennej, gdzie przechowywane są właściwości (zazwyczaj zmienną klasy).hBlobDefault
Wartość domyślna właściwości.
Wartość zwracana
Niezerowa, jeśli wymiany powiodła się; 0, jeśli nie powiedzie.
Uwagi
Wartość właściwości będzie odczytać lub zapisywane do zmiennej odwołuje się hBlob, odpowiednio.Zmienna ta powinna zostać zainicjowana do NULL przed wywołaniem początkowo PX_Blob po raz pierwszy (zazwyczaj można to zrobić w konstruktorze formantu).Jeśli hBlobDefault jest określona, będzie on używany jako wartość domyślna właściwości.Ta wartość jest używana, jeśli z jakiegokolwiek powodu nie powiedzie się procesu inicjowania lub serializacji tego formantu.
Uchwyty hBlob i hBlobDefault odnoszą się do bloku pamięci, który zawiera następujące:
A DWORD który zawiera długość danych binarnych, który następuje, w bajtach, a następnie natychmiast przez
Blok pamięci zawierający rzeczywiste dane binarne.
Należy zauważyć, że PX_Blob przyzna pamięci przy użyciu systemu Windows działanie funkcji GlobalAlloc API, podczas ładowania właściwości typu BLOB.Jesteś odpowiedzialny za zwolnienie tej pamięci.Dlatego należy wywołać destruktora formantu GlobalFree na dowolnej właściwości typu BLOB dojścia do wolnego konfigurowanie wszelkich pamięć przydzielona dla formantu.
Wymagania
Nagłówek: afxctl.h