PX_Blob
Rufen Sie diese Funktion in DoPropExchange-Memberfunktion des Steuerelements auf, um eine Eigenschaft serialisiert oder initialisieren, die Binary Large Object-Daten (BLOB) speichert.
BOOL PX_Blob(
CPropExchange* pPX,
LPCTSTR pszPropName,
HGLOBAL& hBlob,
HGLOBAL hBlobDefault = NULL
);
Parameter
pPX
Zeiger zum CPropExchange-Objekt (in der Regel an als Parameter für DoPropExchange).pszPropName
Der Name der Eigenschaft, die ausgetauscht wird.hBlob
Verweis auf die Variable, in der die Eigenschaft gespeichert (in der Regel eine Membervariable der Klasse).hBlobDefault
Standardwert für die Eigenschaft.
Rückgabewert
Wert ungleich 0 (null), wenn der Austausch erfolgreich war; wenn 0 fehlgeschlagen.
Hinweise
Der Eigenschaftswert wird aus gelesen oder geschrieben der Variablen, die von hBlob, je verwiesen wird. Diese Variable sollte zu NULL initialisiert werden, bevor sie zuerst zum ersten Mal PX_Blob aufruft (in der Regel, kann dieses im Konstruktor des Steuerelements ausgeführt werden). Wenn hBlobDefault angegeben wird, wird es als der Standardwert der Eigenschaft verwendet. Dieser Wert wird verwendet, wenn für jeden, Grund, die Initialisierung des Steuerelements oder der Serialisierungsprozess fehlschlägt.
Die Steuerpunkte hBlob und hBlobDefault verweisen auf einen Speicherblock an, der Folgendes enthält:
DWORD, die die Länge, in Bytes, Binärdaten enthält, die erfolgreich ist, direkt gefolgt von
Ein der Speicherblock, die tatsächlichen Binärdaten enthält.
Beachten Sie, dass PX_Blob, mit der API Windows GlobalAlloc Speicher belegt, wenn Blobtypeigenschaften lädt. Sie sind für das Freigeben des Arbeitsspeichers zuständig. Daher sollte der Destruktor des Steuerelements GlobalFree ausschließlich Blobtypeigenschaftenhandles aufrufen, um einem Arbeitsspeicher freizugeben, der dem Steuerelement zugeordnet ist.
Anforderungen
Header: afxctl.h