Función DdePostAdvise (ddeml.h)

Hace que el sistema envíe una transacción de XTYP_ADVREQ a la función de devolución de llamada de intercambio de datos dinámicos (DDE) de la aplicación que realiza la llamada (servidor) para cada cliente con un bucle de aviso activo en el tema y el elemento especificados. Una aplicación de servidor debe llamar a esta función cada vez que cambian los datos asociados al nombre del tema o al par de nombres de elemento.

Sintaxis

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

Parámetros

[in] idInst

Tipo: DWORD

Identificador de instancia de aplicación obtenido por una llamada anterior a la función DdeInitialize .

[in] hszTopic

Tipo: HSZ

Identificador de una cadena que especifica el nombre del tema. Para enviar notificaciones para todos los temas con bucles de aviso activos, una aplicación puede establecer este parámetro en 0L.

[in] hszItem

Tipo: HSZ

Identificador de una cadena que especifica el nombre del elemento. Para enviar notificaciones para todos los elementos con bucles de aviso activo, una aplicación puede establecer este parámetro en 0L.

Valor devuelto

Tipo: BOOL

Si la función se realiza correctamente, el valor devuelto es distinto de cero.

Si la función no se realiza correctamente, el valor devuelto es cero.

La función DdeGetLastError se puede usar para obtener el código de error, que puede ser uno de los siguientes valores:

Comentarios

Un servidor que tenga temas o elementos no numerables debe establecer los parámetros hszTopic y hszItem en NULL para que el sistema genere transacciones para todos los bucles de aviso activos. La función de devolución de llamada DDE del servidor devuelve NULL para los bucles de aviso que no se deben actualizar.

Si un servidor llama a DdePostAdvise con un conjunto de nombres de tema, elemento y formato que incluye el conjunto que se está controlando actualmente en una devolución de llamada de XTYP_ADVREQ , puede producirse un desbordamiento de pila.

Requisitos

Requisito Value
Cliente mínimo compatible Windows 2000 Professional [solo aplicaciones de escritorio]
Servidor mínimo compatible Windows 2000 Server [solo aplicaciones de escritorio]
Plataforma de destino Windows
Encabezado ddeml.h (incluya Windows.h)
Library User32.lib
Archivo DLL User32.dll

Consulte también

Conceptual

DdeInitialize

Biblioteca de administración dinámica de Intercambio de datos

Referencia

XTYP_ADVREQ