DdeUninitialize

3.1

  #include <ddeml.h>    

  BOOL DdeUninitialize(idInst)    
  DWORD idInst; /* instance identifier, */  

The DdeUninitialize function frees all Dynamic Data Exchange Management Library (DDEML) resources associated with the calling application.

Parameters

idInst

Specifies the application-instance identifier obtained by a previous call to the DdeInitialize function.

Return Value

The return value is nonzero if the function is successful. Otherwise, it is zero.

Comments

The DdeUninitialize function terminates any conversations currently open for the application. If the partner in a conversation fails to terminate its end of the conversation, the system may enter a modal loop while it waits for the conversation to terminate. A timeout period is associated with this loop. If the timeout period expires

before the conversation has terminated, a message box appears that gives the user the choice of waiting for another timeout period (Retry), waiting indefinitely (Ignore), or exiting the modal loop (Abort).

An application should wait until its windows are no longer visible and its message loop has terminated before calling this function.

See Also

DdeDisconnect, DdeDisconnectList, DdeInitialize