PX_Blob

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

Valeur de retour

Différent de zéro si l'échange a été un succès ; 0 en cas d'échec.

Paramètres

pPX

Pointeur vers l'objet CPropExchange (généralement transmis comme paramètre à DoPropExchange).

pszPropName

Le nom de la propriété d'être échangée.

hBlob

Référence à la variable où la propriété est stockée (généralement une variable membre de votre classe).

hBlobDefault

Valeur par défaut de la propriété.

Remarques

Appelez cette fonction au sein de votre contrôle DoPropExchange fonction membre à sérialiser ou à initialiser une propriété qui stocke les données de l'objet binaire volumineux (BLOB). La valeur du bien sera lire ou écrite à la variable référencée par hBlob, selon le cas. Cette variable doit être initialisée à NULL avant d'abord appeler PX_Blob pour la première fois (en général, cela peut se faire dans le constructeur du contrôle). Si hBlobDefault est spécifié, il sera utilisé comme valeur par défaut de la propriété. Cette valeur est utilisée si, pour une raison quelconque, le processus d'initialisation ou de la sérialisation du contrôle échoue.

Les poignées hBlob et hBlobDefault désignent un bloc de mémoire qui contient les éléments suivants:

• Un DWORD qui contient la longueur, en octets, des données binaires qui suit, suivie immédiatement par
  
  
• Un bloc de mémoire contenant les données binaires.

Notez que PX_Blob va allouer de la mémoire, en utilisant le Windows GlobalAlloc API, lors du chargement des propriétés de type BLOB. Vous êtes responsable de libérer cette mémoire. Par conséquent, le destructeur de votre contrôle doit appeler GlobalFree sur une propriété de type BLOB gère afin de libérer la mémoire allouée à votre contrôle.

Voir aussi  ;COleControl::DoPropExchange