DDEPoke( ) (Función)

  • Artículo

Envía datos entre las aplicaciones cliente y servidor en una conversación de intercambio dinámico de datos (DDE).

DDEPoke(nChannelNumber, cItemName, cDataSent
   [, cDataFormat [, cUDFName]])

Valores devueltos

Logical

Parámetros

  • nChannelNumber
    Especifica el número de canal de la aplicación a la que se enviarán los datos. Si el número de canal es un canal servidor, DDEPoke( ) enviará los datos como respuesta a una petición de un vínculo de notificación o automático establecido previamente.

  • cItemName
    Especifica el nombre de elemento al que se enviarán los datos. El nombre de elemento es específico de la aplicación y debe ser comprensible para la aplicación. Por ejemplo, Microsoft Excel admite R1C1 como nombre de elemento válido que hace referencia a la primera celda de una hoja de cálculo.

  • cDataSent
    Especifica los datos enviados al nombre de elemento especificado con cItemName.

  • cDataFormat
    Especifica el formato utilizado para enviar los datos. El formato predeterminado es CF_TEXT. En este formato, los campos se delimitan mediante tabulaciones y los registros se delimitan mediante un retorno de carro y un avance de línea.

  • cUDFName
    Permite la transferencia asíncrona de datos. Si se omite cUDFName, el cliente esperará el período especificado mediante DDESetOption( ). Si especifica el nombre de una FDU mediante cUDFName, la ejecución del programa cliente continuará inmediatamente después de que se haga la petición.

    Cuando los datos están disponibles en la aplicación de servidor, la FDU especificada mediante cUDFName se ejecuta. Se transfieren a la FDU seis parámetros en este orden:

    Parámetro Contenido
    Channel Number Número de canal de la aplicación de servidor.
    Action XACTCOMPLETE (transacción correcta).XACTFAIL (transacción incorrecta).
    Item Nombre del elemento; por ejemplo, R1C1 para una celda de una hoja de cálculo de Microsoft Excel.
    Data Los nuevos datos (REQUEST) o los datos transferidos (POKE o EXECUTED).
    Format Formato de datos; por ejemplo, CF_TEXT.
    Transaction Number El número de transacción devuelto por DDEPoke( ).

    Utilice DDEAbortTrans( ) para cancelar una transacción incompleta. Si la transacción falla, podrá utilizar DDELastError( ) para determinar por qué ha fallado.

    Cuando incluya cUDFName, DDEPoke( ) devolverá un número de transacción si lo logra o –1 si se produce un error.

Observaciones

DDEPoke( ) envía datos como una cadena de caracteres al nombre del elemento en la aplicación especificada por el número de canal.

Si logran enviarse los datos, DDEPoke( ) devolverá verdadero (.T.). Si no pueden enviarse los datos DDEPoke( ) devolverá falso (.F.). Si se incluye la FDU asíncrona cUDFName, DDEPoke( ) devolverá un número de transacción; si se produce un error, devolverá –1.

Vea también

DDEAbortTrans( ) | DDEInitiate( ) | DDELastError( ) | DDESetOption( ) | DDETerminate( )