Edit

NETCON_STATUS enumeration (netcon.h)

  • Article

[Internet Connection Firewall may be altered or unavailable in subsequent versions. Instead, use the Windows Firewall API.]

The NETCON_STATUS type enumerates possible status conditions for a network connection.

Syntax

typedef enum tagNETCON_STATUS {
  NCS_DISCONNECTED = 0,
  NCS_CONNECTING,
  NCS_CONNECTED,
  NCS_DISCONNECTING,
  NCS_HARDWARE_NOT_PRESENT,
  NCS_HARDWARE_DISABLED,
  NCS_HARDWARE_MALFUNCTION,
  NCS_MEDIA_DISCONNECTED,
  NCS_AUTHENTICATING,
  NCS_AUTHENTICATION_SUCCEEDED,
  NCS_AUTHENTICATION_FAILED,
  NCS_INVALID_ADDRESS,
  NCS_CREDENTIALS_REQUIRED,
  NCS_ACTION_REQUIRED,
  NCS_ACTION_REQUIRED_RETRY,
  NCS_CONNECT_FAILED
} NETCON_STATUS;

Constants

 
NCS_DISCONNECTED
Value: 0
The connection is disconnected.
NCS_CONNECTING
The connection is in the process of connecting.
NCS_CONNECTED
The connection is in a connected state.
NCS_DISCONNECTING
The connection is in the process of disconnecting.
NCS_HARDWARE_NOT_PRESENT
The hardware for the connection, for example network interface card (NIC), is not present.
NCS_HARDWARE_DISABLED
The hardware for the connection is present, but is not enabled.
NCS_HARDWARE_MALFUNCTION
A malfunction has occurred in the hardware for the connection.
NCS_MEDIA_DISCONNECTED
The media, for example the network cable, is disconnected.
NCS_AUTHENTICATING
The connection is waiting for authentication to occur.
NCS_AUTHENTICATION_SUCCEEDED
Authentication has succeeded on this connection.
NCS_AUTHENTICATION_FAILED
Authentication has failed on this connection.
NCS_INVALID_ADDRESS
The address is invalid.
NCS_CREDENTIALS_REQUIRED
Security credentials are required.
NCS_ACTION_REQUIRED
NCS_ACTION_REQUIRED_RETRY
NCS_CONNECT_FAILED

Requirements

Requirement Value
Minimum supported client Windows XP [desktop apps only]
Minimum supported server None supported
Header netcon.h

See also

INetConnection

Internet Connection Sharing and Internet Connection Firewall Enumeration Types

Internet Connection Sharing and Internet Connection Firewall Reference

NETCON_PROPERTIES