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 |
|
|
Library |
|
|
DLL |
|