DdeGetLastError function (ddeml.h)
Retrieves the most recent error code set by the failure of a Dynamic Data Exchange Management Library (DDEML) function and resets the error code to DMLERR_NO_ERROR.
Syntax
UINT DdeGetLastError(
[in] DWORD idInst
);
Parameters
[in] idInst
Type: DWORD
The application instance identifier obtained by a previous call to the DdeInitialize function.
Return value
Type: UINT
If the function succeeds, the return value is the last error code, which can be one of the following values.
| Return code/value | Description |
|---|---|
|
A request for a synchronous advise transaction has timed out. |
|
The response to the transaction caused the DDE_FBUSY flag to be set. |
|
A request for a synchronous data transaction has timed out. |
|
A DDEML function was called without first calling the DdeInitialize function, or an invalid instance identifier was passed to a DDEML function. |
|
An application initialized as APPCLASS_MONITOR has attempted to perform a DDE transaction, or an application initialized as APPCMD_CLIENTONLY has attempted to perform server transactions. |
|
A request for a synchronous execute transaction has timed out. |
|
A parameter failed to be validated by the DDEML. Some of the possible causes follow:
The application used a data handle initialized with a different item name handle than was required by the transaction. The application used a data handle that was initialized with a different clipboard data format than was required by the transaction. The application used a client-side conversation handle with a server-side function or vice versa. The application used a freed data handle or string handle. More than one instance of the application used the same object. |
|
A DDEML application has created a prolonged race condition (in which the server application outruns the client), causing large amounts of memory to be consumed. |
|
A memory allocation has failed. |
|
A client's attempt to establish a conversation has failed. |
|
A transaction has failed. |
|
A request for a synchronous poke transaction has timed out. |
|
An internal call to the PostMessage function has failed. |
|
An application instance with a synchronous transaction already in progress attempted to initiate another synchronous transaction, or the DdeEnableCallback function was called from within a DDEML callback function. |
|
A server-side transaction was attempted on a conversation terminated by the client, or the server terminated before completing a transaction. |
|
An internal error has occurred in the DDEML. |
|
A request to end an advise transaction has timed out. |
|
An invalid transaction identifier was passed to a DDEML function. Once the application has returned from an XTYP_XACT_COMPLETE callback, the transaction identifier for that callback function is no longer valid. |
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 |
See also
Conceptual
Dynamic Data Exchange Management Library
Reference