DDEInitiate( ) (Función)

  • Artículo

Establece un canal de intercambio dinámico de datos (DDE) entre Visual FoxPro y otra aplicación basada en Microsoft Windows.

DDEInitiate(cServiceName, cTopicName)

Valores devueltos

Numeric

Parámetros

  • cServiceName
    Especifica el nombre de servicio de la aplicación de servidor que, en la mayoría de los casos, es el nombre del archivo ejecutable sin su extensión. El nombre de servicio predeterminado para Visual FoxPro es Visual FoxPro. Si va a establecer un canal con Microsoft Excel, cServiceName será Excel.
  • cTopicName
    Especifica el nombre de tema. El tema es específico de la aplicación y debe ser comprensible para la aplicación. Por ejemplo, un tema suministrado por la mayoría de servidores DDE es el tema System. Consulte en la documentación de la aplicación los nombres de servicio y de tema proporcionados por la aplicación.

Observaciones

DDEInitiate( ) establece un canal DDE entre Visual FoxPro y la aplicación de servidor DDE. Una vez que el canal se ha establecido, Visual FoxPro puede pedir datos del servidor al hacer referencia al canal en las funciones DDE subsiguientes. Visual FoxPro actúa como el cliente, ya que pide datos de la aplicación de servidor a través del canal.

Si logra establecerse el canal, DDEInitiate( ) devolverá el número de canal. Los canales tienen números positivos y el número de canales que puede establecer está limitado únicamente por los recursos del sistema.

DDEInitiate( ) devolverá –1 si no puede establecerse el canal. Si la aplicación de servidor no está abierta, Visual FoxPro le preguntará si desea abrirla. Si elige “Sí”, Visual FoxPro intentará abrir la aplicación. (Puede utilizar DDELastError( ) para determinar por qué no puede establecerse un canal.)

Para evitar que se le pregunte si desea abrir la aplicación, establezca la opción SAFETY de DDESetOption( ). También puede utilizar RUN con la opción /N para iniciar la aplicación.

Un canal puede cerrarse mediante DDETerminate( ).

Ejemplo

El ejemplo siguiente usa DDEInitiate( ) para establecer un canal DDE entre Visual FoxPro y una hoja de cálculo de Microsoft Excel llamada Sheet1. 'Excel' es el nombre de servicio y 'Sheet1' es el nombre de tema. El número de canal se almacena en la variable de memoria mchannum para su uso en posteriores funciones DDE.

mchannum = DDEInitiate('Excel', 'Sheet1')
IF mchannum != -1
   * Process client actions
   = DDETerminate(mchannum)  && Close the channel
ENDIF

Vea también

DDEAdvise( ) | DDEEnabled( ) | DDEExecute( ) | DDELastError( ) | DDEPoke( ) | DDERequest( ) | DDESetOption( ) | DDETerminate( ) | RUN | !