WS_LISTENER_STATE enumeration (webservices.h)

The different states that a listener can be in.

Syntax

typedef enum {
  WS_LISTENER_STATE_CREATED = 0,
  WS_LISTENER_STATE_OPENING = 1,
  WS_LISTENER_STATE_OPEN = 2,
  WS_LISTENER_STATE_FAULTED = 3,
  WS_LISTENER_STATE_CLOSING = 4,
  WS_LISTENER_STATE_CLOSED = 5
} WS_LISTENER_STATE;

Constants

 
WS_LISTENER_STATE_CREATED
Value: 0
WS_LISTENER_STATE_OPENING
Value: 1
WS_LISTENER_STATE_OPEN
Value: 2
WS_LISTENER_STATE_FAULTED
Value: 3
WS_LISTENER_STATE_CLOSING
Value: 4
WS_LISTENER_STATE_CLOSED
Value: 5

Remarks

The following are the state transitions for a Listener.

Diagram showing the possible states of a Listener object and the transitions between them.

A listener will only move to WS_LISTENER_STATE_FAULTED state if WsAbortListener is called.

Note that only the valid state transitions are shown. Using a function not shown for a given state will result in an WS_E_INVALID_OPERATION error being returned from the function (or crash in the case of WsFreeListener). See Windows Web Services Return Values.

Requirements

Requirement Value
Minimum supported client Windows 7 [desktop apps only]
Minimum supported server Windows Server 2008 R2 [desktop apps only]
Header webservices.h