Compartilhar via


Função DdeGetData (ddeml.h)

Copia dados do objeto DDE (Dynamic Data Exchange) especificado para o buffer local especificado.

Sintaxe

DWORD DdeGetData(
  [in]            HDDEDATA hData,
  [out, optional] LPBYTE   pDst,
  [in]            DWORD    cbMax,
  [in]            DWORD    cbOff
);

Parâmetros

[in] hData

Tipo: HDDEDATA

Um identificador para o objeto DDE que contém os dados a serem copiados.

[out, optional] pDst

Tipo: LPBYTE

Um ponteiro para o buffer que recebe os dados. Se esse parâmetro for NULL, a função DdeGetData retornará a quantidade de dados, em bytes, que seriam copiados para o buffer.

[in] cbMax

Tipo: DWORD

A quantidade máxima de dados, em bytes, para copiar para o buffer apontado pelo parâmetro pDst . Normalmente, esse parâmetro especifica o comprimento do buffer apontado por pDst.

[in] cbOff

Tipo: DWORD

Um deslocamento dentro do objeto DDE. Os dados são copiados do objeto que começa neste deslocamento.

Valor retornado

Tipo: DWORD

Se o parâmetro pDst apontar para um buffer, o valor retornado será o tamanho, em bytes, do objeto de memória associado ao identificador de dados ou ao tamanho especificado no parâmetro cbMax , o que for menor.

Se o parâmetro pDst for NULL, o valor retornado será o tamanho, em bytes, do objeto de memória associado ao identificador de dados.

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

Requisitos

   
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

Confira também

Conceitual

DdeAccessData

DdeCreateDataHandle

DdeFreeDataHandle

Biblioteca de Gerenciamento dinâmico do Data Exchange

Referência