LabWindows/CVI

UnregisterDDEServer

int UnregisterDDEServer (char serverName[]);

Purpose

Removes your program from its capacity as a DDE server under the specified server name. No further service is provided. All connections with clients are closed. The server callback function is no longer called for this server name.

UnregisterDDEServer returns zero for success or a negative error code for failure.

Parameters

Input
Name Type Description
serverName char [] The name of the server to be unregistered. This must match the server name that was passed to RegisterDDEServer. serverName is case insensitive.

Return Value

Name Type Description
status int Return value indicating whether the function was successful.

A negative number represents the error code. For functions that read or write data (ClientDDERead, ClientDDEWrite, ServerDDEWrite, AdviseDDEDataReady, BroadcastDDEDataReady), if the function was successful, the return value is the number of bytes transferred. For other DDE Support Library functions, zero represents successful execution.

The enumerated type that specifies the absolute values of the error codes is declared in ddesupp.h. For instance, if an invalid parameter is passed, kDDE_InvalidParameter is returned.

Currently, a maximum of 255 concurrent conversations are allowed at any one time. If you exceed this limit, –kDDE_TooManyConversations will be returned.

Error codes from –16 to –33 are native DDEML errors, which correspond to Windows DDE error codes starting from 0x4000.

Additional Information

Library: DDE Support Library

Include file: ddesupp.h

LabWindows/CVI compatibility: LabWindows/CVI 3.0 and later