WsFreeListener function

Releases the memory resource associated with a Listener object. The Listener state represented in WS_LISTENER_STATE must be set to either WS_LISTENER_STATE_CREATED or WS_LISTENER_STATE_CLOSED to be released. If a Listener has been successfully opened, then it must be closed using WsCloseListener before it is released.

Syntax


void WINAPI  WsFreeListener(
  _In_ WS_LISTENER *listener
);

Parameters

listener [in]

A pointer to the Listener object to release. The pointer must reference a valid WS_LISTENER returned by WsCreateListener. The referenced value may not be NULL.

Return value

This function does not return a value.

Security

Freeing a listener that is not in the WS_LISTENER_STATE_CREATED or WS_LISTENER_STATE_CLOSED states will cause an access violation. There may still be IO pending if the listener is not in one of these states.

Requirements

Minimum supported client

Windows 7 [desktop apps only]

Minimum supported server

Windows Server 2008 R2 [desktop apps only]

Header

WebServices.h

Library

WebServices.lib

DLL

WebServices.dll

 

 

Community Additions

ADD
Show: