Función DdeAddData (ddeml.h)

Agrega datos al objeto de intercambio dinámico de datos (DDE) especificado. Una aplicación puede agregar datos a partir de cualquier desplazamiento desde el principio del objeto. Si los nuevos datos ya se superponen en el objeto , los nuevos datos sobrescriben los datos antiguos en los bytes donde se produce la superposición. El contenido de las ubicaciones del objeto en el que no se ha escrito no está definido.

Sintaxis

HDDEDATA DdeAddData(
  [in] HDDEDATA hData,
  [in] LPBYTE   pSrc,
  [in] DWORD    cb,
  [in] DWORD    cbOff
);

Parámetros

[in] hData

Tipo: HDDEDATA

Identificador del objeto DDE que recibe datos adicionales.

[in] pSrc

Tipo: LPBYTE

Datos que se van a agregar al objeto DDE.

[in] cb

Tipo: DWORD

Longitud, en bytes, de los datos que se van a agregar al objeto DDE, incluido el valor NULL de terminación, si los datos son una cadena.

[in] cbOff

Tipo: DWORD

Desplazamiento, en bytes, desde el principio del objeto DDE. Los datos adicionales se copian en el objeto comenzando en este desplazamiento.

Valor devuelto

Tipo: HDDEDATA

Si la función se ejecuta correctamente, el valor devuelto es un nuevo identificador para el objeto DDE. El nuevo identificador se usa en todas las referencias al objeto .

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

Una vez que se ha usado un identificador de datos como parámetro en otra función de biblioteca de administración dinámica de Exchange de datos o se ha devuelto mediante una función de devolución de llamada DDE, el identificador solo se puede usar para el acceso de lectura al objeto DDE identificado por el identificador.

Si la cantidad de memoria asignada originalmente es menor que la necesaria para contener los datos agregados, DdeAddData reasigna un objeto de memoria global del tamaño adecuado.

Requisitos

Consulte también

Conceptual

DdeAccessData

DdeCreateDataHandle

DdeUnaccessData

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

Referencia