ServerState

The ServerState property presents the current state of the server instance.

The states have friendly identifiers defined in the IIScnfg.h header file, and are as follows:

Value	Meaning	Friendly ID
1	Starting	MD_SERVER_STATE_STARTING
2	Started	MD_SERVER_STATE_STARTED
3	Stopping	MD_SERVER_STATE_STOPPING
4	Stopped	MD_SERVER_STATE_STOPPED
5	Pausing	MD_SERVER_STATE_PAUSING
6	Paused	MD_SERVER_STATE_PAUSED
7	Continuing	MD_SERVER_STATE_CONTINUING

Note

This property reflects the state of the IIS server and should be treated as read-only. When configuring the metabase with Admin Base Object (ABO), use the MD_SERVER_COMMAND property to send start, stop, and pause commands to the server. When using ADSI or WMI, use the methods of the IIsFtpServer and IIsWebServer objects. You can also use the methods of the IIisServiceControl interface to control the server in a compiled IIS application.

Schema Attributes

Attribute Name	Value
ADSI/WMI Data Type	DWORD
ABO Data Type	DWORD_METADATA
Schema Default	4
Internal Default	Not specified.
Upper Bound	Not specified
Lower Bound	Not specified
Internal ID	1016
Friendly ID	MD_SERVER_STATE
Property Attributes	VOLATILE
User Type	IIS_MD_UT_SERVER

Configurable Locations

You can configure this property at the following locations in the IIS metabase.

Metabase Path	IIS Admin Object Type
/LM/W3SVC/n	IIsWebServer
/LM/MSFTPSVC/n	IIsFtpServer
/LM/NNTPSVC/n	IIsNntpServer
/LM/SMTPSVC/n	IIsSmtpServer

Flags

There are no flags for this property.

Requirements

Client: Requires Windows XP Professional, Windows 2000 Professional, or Windows NT Workstation 4.0.

Server: Requires Windows Server 2003, Windows 2000 Server, or Windows NT Server 4.0.

Product: IIS

See Also