Edit

Share via

WsResetListener function (webservices.h)

  • Article

Resets a Listener object so it can be reused.

Use of this function requires that the Listener state be set to WS_LISTENER_STATE_CREATED or WS_LISTENER_STATE_CLOSED.

Syntax

HRESULT WsResetListener(
  [in]           WS_LISTENER *listener,
  [in, optional] WS_ERROR    *error
);

Parameters

[in] listener

A pointer to the Listener object to reset. The pointer must reference a valid WS_LISTENER.

[in, optional] error

A pointer to a WS_ERROR object where additional information about the error should be stored if the function fails.

Return value

This function can return one of these values.

Return code Description
WS_E_INVALID_OPERATION
 The listener was in an inappropriate state.

Remarks

Before reusing a listener, this function should be called.

Requirements

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