WsFreeChannel function (webservices.h)

Releases the memory resource associated with a Channel object.

The Channel must be in the either the WS_CHANNEL_STATE_CREATED or WS_CHANNEL_STATE_CLOSED state to be released. If a Channel has been successfully opened it must be closed before it can be released.

Syntax

void WsFreeChannel(
  [in] WS_CHANNEL *channel
);

Parameters

[in] channel

A pointer to the Channel object to release. The pointer must reference a valid WS_CHANNEL object returned by WsCreateChannel or WsCreateChannelForListener. The referenced value may not be NULL.

Return value

None

Remarks

A channel that is in the process of being accepted/opened cannot be released until the accept/open completes. Use WsAbortChannel to cancel the accept/open process.

Requirements

Requirement Value
Minimum supported client Windows 7 [desktop apps | UWP apps]
Minimum supported server Windows Server 2008 R2 [desktop apps | UWP apps]
Target Platform Windows
Header webservices.h
Library WebServices.lib
DLL WebServices.dll