Função DdeAddData (ddeml.h)

Artigo
02/26/2024

Adiciona dados ao objeto DDE (Dynamic Data Exchange) especificado. Um aplicativo pode adicionar dados a partir de qualquer deslocamento do início do objeto. Se novos dados se sobrepõem aos dados já no objeto , os novos dados substituirão os dados antigos nos bytes em que a sobreposição ocorre. O conteúdo dos locais no objeto que não foram gravados são indefinidos.

Sintaxe

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

Parâmetros

[in] hData

Tipo: HDDEDATA

Um identificador para o objeto DDE que recebe dados adicionais.

[in] pSrc

Tipo: LPBYTE

Os dados a serem adicionados ao objeto DDE.

[in] cb

Tipo: DWORD

O comprimento, em bytes, dos dados a serem adicionados ao objeto DDE, incluindo o NULL de terminação, se os dados forem uma cadeia de caracteres.

[in] cbOff

Tipo: DWORD

Um deslocamento, em bytes, desde o início do objeto DDE. Os dados adicionais são copiados para o objeto a partir desse deslocamento.

Retornar valor

Tipo: HDDEDATA

Se a função for bem-sucedida, o valor retornado será um novo identificador para o objeto DDE. O novo identificador é usado em todas as referências ao objeto .

Se a função falhar, o valor retornado será zero.

A função DdeGetLastError pode ser usada para obter o código de erro, que pode ser um dos seguintes valores:

Comentários

Depois que um identificador de dados tiver sido usado como um parâmetro em outra função da Biblioteca de Gerenciamento do Dynamic Data Exchange ou tiver sido retornado por uma função de retorno de chamada DDE, o identificador só poderá ser usado para acesso de leitura ao objeto DDE identificado pelo identificador.

Se a quantidade de memória originalmente alocada for menor do que o necessário para manter os dados adicionados, DdeAddData realocará um objeto de memória global do tamanho apropriado.

Requisitos

Requisito	Valor
Cliente mínimo com suporte	Windows 2000 Professional [somente aplicativos da área de trabalho]
Servidor mínimo com suporte	Windows 2000 Server [somente aplicativos da área de trabalho]
Plataforma de Destino	Windows
Cabeçalho	ddeml.h (inclua Windows.h)
Biblioteca	User32.lib
DLL	User32.dll