Compartilhar via


Função DdeAccessData (ddeml.h)

Fornece acesso aos dados no objeto DDE (Dynamic Data Exchange) especificado. Um aplicativo deve chamar a função DdeUnaccessData quando terminar de acessar os dados no objeto .

Sintaxe

LPBYTE DdeAccessData(
  [in]            HDDEDATA hData,
  [out, optional] LPDWORD  pcbDataSize
);

Parâmetros

[in] hData

Tipo: HDDEDATA

Um identificador para o objeto DDE a ser acessado.

[out, optional] pcbDataSize

Tipo: LPDWORD

Um ponteiro para uma variável que recebe o tamanho, em bytes, do objeto DDE identificado pelo parâmetro hData . Se esse parâmetro for NULL, nenhuma informação de tamanho será retornada.

Valor retornado

Tipo: LPBYTE

Se a função for bem-sucedida, o valor retornado será um ponteiro para o primeiro byte de dados no objeto DDE.

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

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

Comentários

Se o parâmetro hData não tiver sido passado para uma função DDEML (Dynamic Data Exchange Management Library), um aplicativo poderá usar o ponteiro retornado por DdeAccessData para acesso de leitura-gravação ao objeto DDE. Se hData já tiver sido passado para uma função DDEML, o ponteiro deverá ser usado apenas para acesso de leitura ao objeto de memória.

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

DdeAddData

DdeCreateDataHandle

DdeFreeDataHandle

DdeUnaccessData

Biblioteca de Gerenciamento dinâmico do Data Exchange

Referência