Compartilhar via


PX_Blob

Chamar essa função dentro do controle DoPropExchange função de membro para serializar ou inicializar uma propriedade que armazena dados de objeto binário grande (BLOB).

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

Parâmetros

  • pPX
    Ponteiro para o CPropExchange objeto (normalmente passado como um parâmetro para DoPropExchange).

  • pszPropName
    O nome da propriedade que está sendo trocado.

  • hBlob
    Referência à variável onde a propriedade é armazenada (geralmente uma variável de membro de sua classe).

  • hBlobDefault
    Valor padrão da propriedade.

Valor de retorno

Diferente de zero se o exchange foi bem-sucedida; 0 se não houver êxito.

Comentários

O valor da propriedade será ser lido ou gravado para a variável referenciada por hBlob, conforme apropriado.Esta variável deve ser inicializada para Nulo antes de chamar inicialmente PX_Blob pela primeira vez (normalmente, isso pode ser feito no construtor do controle).Se hBlobDefault for especificado, será usado como o valor da propriedade padrão.Esse valor é usado se, por qualquer motivo, o processo de inicialização ou serialização do controle falhar.

As alças de hBlob e hBlobDefault consulte um bloco de memória que contém o seguinte:

  • A DWORD que contém o comprimento, em bytes, dos dados binários que segue, seguido imediatamente por

  • Um bloco de memória que contém os dados binários reais.

Observe que PX_Blob alocará memória, usando o Windows GlobalAlloc API, ao carregar propriedades de tipo de BLOB.Você é responsável por liberando memória.Portanto, o destruidor de seu controle deve chamar GlobalFree em qualquer propriedade de tipo BLOB alças livre até qualquer memória alocada para o seu controle.

Requisitos

Cabeçalho: afxctl.h

Consulte também

Referência

COleControl::DoPropExchange

Conceitos

Globais e Macros do MFC