共用方式為


PX_Blob

呼叫控制項的 DoPropExchange 成員函式中的這個函式或初始化存放二進位大型物件 (BLOB) (BLOB) 資料的屬性。

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

參數

  • pPX
    指向CPropExchange 物件的指標 (通常是以參數形式傳遞給 DoPropExchange)。

  • pszPropName
    正在交換的屬性名稱。

  • hBlob
    儲存屬性的變數的參考 (通常是您類別中的成員變數)。

  • hBlobDefault
    屬性的預設值。

傳回值

如果交換成功則非零;如果不成功則為零。

備註

屬性值將被適當地讀取或寫入於 hBlob所參考的變數。 應該使用這個變數加入至在第一次最初呼叫 PX_Blob 之前的 NULL (通常,這會在控制項的建構函式可以做)。 如果指定 hBlobDefault ,它會當做屬性的預設值。 如果由於某種原因,控制的初始化或序列化處理序失敗,這個值則被使用。

處理 hBlob 和 hBlobDefault 都參考包含下列的記憶體區塊:

  • (以位元組為單位),二進位資料的長度,後面接著 DWORD ,後立即

  • 包含實際二進位資料的記憶體區塊。

請注意使用 Windows GlobalAlloc 應用程式開發介面,載入 BLOB 型別的屬性時, PX_Blob 會配置記憶體。 您必須負責釋放此記憶體。 因此,您的控制項解構函式應該會在所有 BLOB 型別的屬性控制代碼的 GlobalFree 釋放任何記憶體配置給您的控制項。

需求

Header: afxctl.h

請參閱

參考

COleControl::DoPropExchange

概念

MFC 巨集和全域