DdeAccessData function (ddeml.h)

Article
10/13/2021

Provides access to the data in the specified Dynamic Data Exchange (DDE) object. An application must call the DdeUnaccessData function when it has finished accessing the data in the object.

Syntax

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

Parameters

[in] hData

Type: HDDEDATA

A handle to the DDE object to be accessed.

[out, optional] pcbDataSize

Type: LPDWORD

A pointer to a variable that receives the size, in bytes, of the DDE object identified by the hData parameter. If this parameter is NULL, no size information is returned.

Return value

Type: LPBYTE

If the function succeeds, the return value is a pointer to the first byte of data in the DDE object.

If the function fails, the return value is NULL.

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

Remarks

If the hData parameter has not been passed to a Dynamic Data Exchange Management Library (DDEML) function, an application can use the pointer returned by DdeAccessData for read-write access to the DDE object. If hData has already been passed to a DDEML function, the pointer should be used only for read access to the memory object.

Requirements

Requirement	Value
Minimum supported client	Windows 2000 Professional [desktop apps only]
Minimum supported server	Windows 2000 Server [desktop apps only]
Target Platform	Windows
Header	ddeml.h (include Windows.h)
Library	User32.lib
DLL	User32.dll