Export (0) Print
Expand All

DdeGetData function

Copies data from the specified Dynamic Data Exchange (DDE) object to the specified local buffer.

Syntax


DWORD WINAPI DdeGetData(
  _In_       HDDEDATA hData,
  _Out_opt_  LPBYTE pDst,
  _In_       DWORD cbMax,
  _In_       DWORD cbOff
);

Parameters

hData [in]

Type: HDDEDATA

A handle to the DDE object that contains the data to copy.

pDst [out, optional]

Type: LPBYTE

A pointer to the buffer that receives the data. If this parameter is NULL, the DdeGetData function returns the amount of data, in bytes, that would be copied to the buffer.

cbMax [in]

Type: DWORD

The maximum amount of data, in bytes, to copy to the buffer pointed to by the pDst parameter. Typically, this parameter specifies the length of the buffer pointed to by pDst.

cbOff [in]

Type: DWORD

An offset within the DDE object. Data is copied from the object beginning at this offset.

Return value

Type: DWORD

If the pDst parameter points to a buffer, the return value is the size, in bytes, of the memory object associated with the data handle or the size specified in the cbMax parameter, whichever is lower.

If the pDst parameter is NULL, the return value is the size, in bytes, of the memory object associated with the data handle.

The DdeGetLastError function can be used to get the error code, which can be one of the following values:

DMLERR_DLL_NOT_INITIALIZED
DMLERR_INVALIDPARAMETER
DMLERR_NO_ERROR

Requirements

Minimum supported client

Windows 2000 Professional [desktop apps only]

Minimum supported server

Windows 2000 Server [desktop apps only]

Header

Ddeml.h (include Windows.h)

Library

User32.lib

DLL

User32.dll

See also

Reference
DdeAccessData
DdeCreateDataHandle
DdeFreeDataHandle
Conceptual
Dynamic Data Exchange Management Library

 

 

Community Additions

ADD
Show:
© 2014 Microsoft