PX_Blob

BOOL PX_Blob ( CPropExchange * pPX, LPCTSTR pszPropName, HGLOB&ALamp; hBlob, HGLOBAL hBlobDefault = Wartość NULL );

Wartość zwracany

Niezerowa, jeśli wymianę był udany; 0, jeżeli niepomyślne.

Parametry

pPX

Wskaźnik do obiektu CPropExchange (zazwyczaj przekazane jako parametr do DoPropExchange).

pszPropName

Nazwa właściwości, wymieniana.

hBlob

Odwołanie do zmiennej, gdy właściwość jest przechowywany (zazwyczaj zmiennej członek klasy).

hBlobDefault

Wartość domyślna właściwości.

Uwagi

Wywołanie tej funkcji w sieci kontroli DoPropExchange funkcji składowej serializować lub zainicjować właściwość, która przechowuje dane dużego obiektu binarnego (BLOB). Wartość właściwości będzie odczytać lub zapisywane do zmiennej odwołuje się hBlob, stosownie do przypadku. Ta zmienna powinny być inicjowane na NULL przed początkowo wywołaniem PX_Blob po raz pierwszy (zazwyczaj można to zrobić w konstruktorze formantu). Jeżeli określono wartość hBlobDefault , będzie używany jako wartość domyślna właściwości. Ta wartość jest używana, jeśli z jakiejkolwiek przyczyny niepowodzenia formantu inicjowania lub serializacji procesu.

Uchwyty hBlob i hBlobDefault odnoszą się do bloku pamięci, który zawiera następujące elementy:

• DWORD , który zawiera długość, w bajtach, dane binarne, które następuje, a następnie natychmiast przez
  
  
• Blok pamięci zawierającej rzeczywiste dane binarne.

Należy zauważyć, że PX_Blob przydzieli pamięć, za pomocą systemu Windows GlobalAlloc API, podczas ładowania właściwości typu BLOB. Użytkownik jest odpowiedzialny za zwalniania tej pamięci. W związku z tym, destruktor formantu powinna wywołać GlobalFree na dowolnej właściwości typu BLOB obsługuje aby zwolnić wszystkie pamięć przydzielona dla formantu.

Zobacz też COleControl::DoPropExchange