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