DdeAccessData
The DdeAccessData
function 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.
LPBYTE DdeAccessData(
|
HDDEDATA hData, |
// handle to DDE
object |
|
LPDWORD pcbDataSize |
// pointer to
variable that receives data length |
|
); |
|
Parameters
hData
Identifies
the DDE object to access.
pcbDataSize
Points 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 Values
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.
Errors
The DdeGetLastError function can be used to get
the error code, which may be one of the following values:
DMLERR_DLL_NOT_INITIALIZED
DMLERR_INVALIDPARAMETER
DMLERR_NO_ERROR
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.
See Also