Función DdeCreateDataHandle (ddeml.h)

Artículo
08/23/2023

Crea un objeto de intercambio dinámico de datos (DDE) y rellena el objeto con datos del búfer especificado. Una aplicación DDE usa esta función durante las transacciones que implican pasar datos a la aplicación asociada.

Sintaxis

HDDEDATA DdeCreateDataHandle(
  [in]           DWORD  idInst,
  [in, optional] LPBYTE pSrc,
  [in]           DWORD  cb,
  [in]           DWORD  cbOff,
  [in, optional] HSZ    hszItem,
  [in]           UINT   wFmt,
  [in]           UINT   afCmd
);

Parámetros

[in] idInst

Tipo: DWORD

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

[in, optional] pSrc

Tipo: LPBYTE

Los datos que se van a copiar en el objeto DDE. Si este parámetro es NULL, no se copia ningún dato en el objeto .

[in] cb

Tipo: DWORD

Cantidad de memoria, en bytes, que se va a copiar desde el búfer al que apunta pSrc. (incluya el valor NULL de terminación, si los datos son una cadena). Si este parámetro es cero, se omite el parámetro pSrc .

[in] cbOff

Tipo: DWORD

Desplazamiento, en bytes, desde el principio del búfer al que apunta el parámetro pSrc . Los datos que comienzan en este desplazamiento se copian del búfer al objeto DDE.

[in, optional] hszItem

Tipo: HSZ

Identificador de la cadena que especifica el elemento de datos correspondiente al objeto DDE. Este identificador debe haber sido creado por una llamada anterior a la función DdeCreateStringHandle . Si el identificador de datos se va a usar en una transacción de XTYP_EXECUTE , este parámetro debe ser 0L.

[in] wFmt

Tipo: UINT

Formato estándar del Portapapeles de los datos.

[in] afCmd

Tipo: UINT

Marcas de creación. Este parámetro puede ser HDATA_APPOWNED, que especifica que la aplicación de servidor que llama a la función DdeCreateDataHandle posee el identificador de datos que crea esta función. Esta marca permite a la aplicación compartir el identificador de datos con otras aplicaciones DDEML en lugar de crear un identificador independiente para pasar a cada aplicación. Si se especifica esta marca, la aplicación debe liberar finalmente el objeto de memoria compartida asociado al identificador mediante la función DdeFreeDataHandle . Si no se especifica esta marca, el identificador se convierte en no válido en la aplicación que creó el identificador después de que la función de devolución de llamada DDE de la aplicación devuelva el identificador de datos o se use como parámetro en otra función DDEML.

Valor devuelto

Tipo: HDDEDATA

Si la función se ejecuta correctamente, el valor devuelto es un identificador de datos.

Si se produce un error en la función, el valor devuelto es 0L.

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

Comentarios

Las ubicaciones no rellenadas del objeto DDE no están definidas.

Una vez que se ha usado un identificador de datos como parámetro en otra función DDEML 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.

Requisitos


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