Função de retorno de chamada PFNCALLBACK (ddeml.h)

  • Artigo

Uma função de retorno de chamada definida pelo aplicativo usada com as funções DDEML ( Dynamic Data Exchange Management Library ). Ele processa transações de DDE (Troca Dinâmica de Dados). O tipo PFNCALLBACK define um ponteiro para essa função de retorno de chamada. DdeCallback é um espaço reservado para o nome da função definida pelo aplicativo.

Sintaxe

PFNCALLBACK Pfncallback;

HDDEDATA Pfncallback(
  [in] UINT wType,
  [in] UINT wFmt,
  [in] HCONV hConv,
  [in] HSZ hsz1,
  [in] HSZ hsz2,
  [in] HDDEDATA hData,
  [in] ULONG_PTR dwData1,
  [in] ULONG_PTR dwData2
)
{...}

Parâmetros

[in] wType

Tipo: UINT

O tipo da transação atual. Esse parâmetro consiste em uma combinação de sinalizadores de classe de transação e sinalizadores de tipo de transação. A tabela a seguir descreve cada uma das classes de transação e fornece uma lista dos tipos de transação em cada classe. Para obter informações sobre um tipo de transação específico, consulte a descrição individual desse tipo em Comentários.

[in] wFmt

Tipo: UINT

O formato no qual os dados são enviados ou recebidos.

[in] hConv

Tipo: HCONV

Um identificador para a conversa associada à transação atual.

[in] hsz1

Tipo: HSZ

Um identificador para uma cadeia de caracteres. O significado desse parâmetro depende do tipo da transação atual. Para obter o significado desse parâmetro, consulte a descrição do tipo de transação em Comentários.

[in] hsz2

Tipo: HSZ

Um identificador para uma cadeia de caracteres. O significado desse parâmetro depende do tipo da transação atual. Para obter o significado desse parâmetro, consulte a descrição do tipo de transação em Comentários.

[in] hData

Tipo: HDDEDATA

Um identificador para dados DDE. O significado desse parâmetro depende do tipo da transação atual. Para obter o significado desse parâmetro, consulte a descrição do tipo de transação em Comentários.

[in] dwData1

Tipo: ULONG_PTR

Dados específicos da transação. Para obter o significado desse parâmetro, consulte a descrição do tipo de transação em Comentários.

[in] dwData2

Tipo: ULONG_PTR

Dados específicos da transação. Para obter o significado desse parâmetro, consulte a descrição do tipo de transação em Comentários.

Valor retornado

Tipo: HDDEDATA

O valor retornado depende da classe de transação. Para obter mais informações sobre os valores retornados, consulte descrições dos tipos de transação individuais.

Comentários

XCLASS_BOOL

Uma função de retorno de chamada DDE deve retornar TRUE ou FALSE quando terminar de processar uma transação que pertence a essa classe. A classe de transação XCLASS_BOOL consiste nos seguintes tipos:

XCLASS_DATA

Uma função de retorno de chamada DDE deve retornar um identificador DDE, o código de retorno CBR_BLOCK ou NULL quando terminar de processar uma transação que pertença a essa classe. A classe de transação XCLASS_DATA consiste nos seguintes tipos:

XCLASS_FLAGS

Uma função de retorno de chamada DDE deve retornar DDE_FACK, DDE_FBUSY ou DDE_FNOTPROCESSED quando terminar de processar uma transação que pertença a essa classe. A classe de transação XCLASS_FLAGS consiste nos seguintes tipos:

XCLASS_NOTIFICATION

Os tipos de transação que pertencem a essa classe são apenas para fins de notificação. O valor retornado da função de retorno de chamada é ignorado. A classe de transação XCLASS_NOTIFICATION consiste nos seguintes tipos:

A função de retorno de chamada é chamada de forma assíncrona para transações que não envolvem a criação ou o encerramento de conversas. Um aplicativo que não aceita mensagens de entrada com frequência terá um desempenho reduzido de DDE porque a DDEML (Biblioteca de Gerenciamento do Dynamic Data Exchange) usa mensagens para iniciar transações.

Um aplicativo deve registrar a função de retorno de chamada especificando um ponteiro para a função em uma chamada para a função DdeInitialize .

Requisitos

   
Cliente mínimo com suporte Windows 2000 Professional [somente aplicativos da área de trabalho]
Servidor mínimo com suporte Windows 2000 Server [somente aplicativos da área de trabalho]
Plataforma de Destino Windows
Cabeçalho ddeml.h (inclua Windows.h)

Confira também

Conceitual

DdeEnableCallback

DdeInitialize

Biblioteca de Gerenciamento dinâmico do Data Exchange