Função DdePostAdvise (ddeml.h)

Faz com que o sistema envie uma transação XTYP_ADVREQ para a função de retorno de chamada DDE (Troca dinâmica de dados) do aplicativo de chamada (servidor) para cada cliente com um loop de consultoria ativo no tópico e item especificados. Um aplicativo de servidor deve chamar essa função sempre que os dados associados ao nome do tópico ou par de nomes de item forem alterados.

Sintaxe

BOOL DdePostAdvise(
  [in] DWORD idInst,
  [in] HSZ   hszTopic,
  [in] HSZ   hszItem
);

Parâmetros

[in] idInst

Tipo: DWORD

O identificador de instância do aplicativo obtido por uma chamada anterior para a função DdeInitialize .

[in] hszTopic

Tipo: HSZ

Um identificador para uma cadeia de caracteres que especifica o nome do tópico. Para enviar notificações para todos os tópicos com loops de consultoria ativos, um aplicativo pode definir esse parâmetro como 0L.

[in] hszItem

Tipo: HSZ

Um identificador para uma cadeia de caracteres que especifica o nome do item. Para enviar notificações para todos os itens com loops de consultoria ativos, um aplicativo pode definir esse parâmetro como 0L.

Retornar valor

Tipo: BOOL

Se a função for bem-sucedida, o valor retornado será diferente de zero.

Se a função falhar, o valor retornado será zero.

A função DdeGetLastError pode ser usada para obter o código de erro, que pode ser um dos seguintes valores:

Comentários

Um servidor que tem tópicos ou itens não numerados deve definir os parâmetros hszTopic e hszItem como NULL para que o sistema gere transações para todos os loops de consultoria ativos. A função de retorno de chamada DDE do servidor retorna NULL para quaisquer loops de consultoria que não devem ser atualizados.

Se um servidor chamar DdePostAdvise com um tópico, item e um conjunto de nomes de formato que inclua o conjunto que está sendo tratado em um XTYP_ADVREQ retorno de chamada, um estouro de pilha poderá resultar.

Requisitos

Requisito	Valor
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)
Biblioteca	User32.lib
DLL	User32.dll

Confira também

Conceitual

DdeInitialize

Biblioteca de Gerenciamento de Troca dinâmica de dados

Referência

XTYP_ADVREQ