PX_Blob

Rufen Sie diese Funktion auf DoPropExchange-Memberfunktion des Steuerelements auf, um eine Eigenschaft zu serialisieren oder zu initialisieren, die Daten vom Binary Large Object (BLOB) gespeichert werden.

BOOL PX_Blob(
   CPropExchange* pPX,
   LPCTSTR pszPropName,
   HGLOBAL& hBlob,
   HGLOBAL hBlobDefault = NULL 
);

Parameter

• pPX
  Zeiger auf den CPropExchange-Objekt (i. d. R. als Parameter zu übergeben DoPropExchange).

• pszPropName
  Der Name der Eigenschaft, die ausgetauscht werden.

• hBlob
  Verweis auf die Variable, in der die Eigenschaft gespeichert ist (meist eine Membervariable der Klasse).

• hBlobDefault
  Standardwert für die Eigenschaft.

Rückgabewert

Ungleich 0 (null), wenn der Austausch erfolgreich war. 0 = fehlschlägt.

Hinweise

Der Wert der Eigenschaft wird aus gelesen oder geschrieben hBlob, die von der Variablen verwiesen wird, oder legt diesen fest.Diese Variable muss initialisiert werden, bevor NULL zuerst zum ersten Mal PX_Blob aufruft (in der Regel kann diese im Konstruktor des Steuerelements geschehen).Wenn hBlobDefault angegeben wird, wird es als der Standardwert der Eigenschaft veranschaulicht.Dieser Wert wird verwendet, wenn aus irgendeinem Grund für die Initialisierung des Steuerelements oder der Serialisierungsprozess fehlschlägt.

Die Ziehpunkte hBlob und hBlobDefault verweisen auf einen Speicherblock an, die Folgendes enthält:

• DWORD, der die Länge in Bytes, der Binärdaten enthält, die sofort folgt, gefolgt von

• Ein Speicherblock, der die Binärdaten enthält.

Beachten Sie, dass PX_Blob mit Windows GlobalAlloc API Speicher belegt, wenn Sie Blobtyp Laden der Eigenschaften.Sie sind für das Freigeben des Speichers verantwortlich.Deshalb sollte der Destruktor des Steuerelements GlobalFree-Eigenschaft Windows-Handle für Blobtyp aufrufen, um einen beliebigen Speicher oben freizugeben, der dem Steuerelement zugeordnet ist.

Anforderungen

Header: afxctl.h

Siehe auch

Referenz

COleControl::DoPropExchange

Konzepte

MFC-Makros und -globale Werte