The NetServiceStatus API uses the following data structure:
struct service_status {
unsigned short svcs_status;
unsigned long svcs_code;
unsigned short svcs_pid;
unsigned char svcs_text[STXTLEN+1];
};
where:
Bits 0 and 1 indicate the general status of the service. 旼컴컴컴컴컴컴컴컴컴컴컴컴컴컴쩡컴컴컴쩡컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴커
� SYMBOLIC CONSTANT � VALUE � MEANING �
쳐컴컴컴컴컴컴컴컴컴컴컴컴컴컴탠컴컴컴탠컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴캑
� SERVICE_UNINSTALLED � 0x00 � Service stopped. �
쳐컴컴컴컴컴컴컴컴컴컴컴컴컴컴탠컴컴컴탠컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴캑
� SERVICE_INSTALL_PENDING � 0x01 � Service start pending. �
쳐컴컴컴컴컴컴컴컴컴컴컴컴컴컴탠컴컴컴탠컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴캑
� SERVICE_UNINSTALL_PENDING � 0x02 � Service stop pending. �
쳐컴컴컴컴컴컴컴컴컴컴컴컴컴컴탠컴컴컴탠컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴캑
� SERVICE_INSTALLED � 0x03 � Service started. �
읕컴컴컴컴컴컴컴컴컴컴컴컴컴컴좔컴컴컴좔컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴켸
The service currently is in one of the following pause states, and bits
2-3 have these values: 旼컴컴컴컴컴컴컴컴컴컴컴컴컴컴쩡컴컴컴쩡컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴커
� SYMBOLIC CONSTANT � VALUE � MEANING �
쳐컴컴컴컴컴컴컴컴컴컴컴컴컴컴탠컴컴컴탠컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴캑
� SERVICE_ACTIVE � 0x00 � Service active. �
쳐컴컴컴컴컴컴컴컴컴컴컴컴컴컴탠컴컴컴탠컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴캑
� SERVICE_CONTINUE_PENDING � 0x04 � Service continue pending. �
쳐컴컴컴컴컴컴컴컴컴컴컴컴컴컴탠컴컴컴탠컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴캑
� SERVICE_PAUSE_PENDING � 0x08 � Service pause pending. �
쳐컴컴컴컴컴컴컴컴컴컴컴컴컴컴탠컴컴컴탠컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴캑
� SERVICE_PAUSED � 0x0C � Service paused. �
읕컴컴컴컴컴컴컴컴컴컴컴컴컴컴좔컴컴컴좔컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴켸
Bit 4 indicates whether the service can be stopped by an application, shown
in the following values: 旼컴컴컴컴컴컴컴컴컴컴컴컴컴컴쩡컴컴컴쩡컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴커
� SYMBOLIC CONSTANT � VALUE � MEANING �
쳐컴컴컴컴컴컴컴컴컴컴컴컴컴컴탠컴컴컴탠컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴캑
� SERVICE_NOT_UNINSTALLABLE � 0x00 � Service cannot be stopped. �
쳐컴컴컴컴컴컴컴컴컴컴컴컴컴컴탠컴컴컴탠컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴캑
� SERVICE_UNINSTALLABLE � 0x10 � Service can be stopped. �
읕컴컴컴컴컴컴컴컴컴컴컴컴컴컴좔컴컴컴좔컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴켸
Bit 5 indicates whether the service can be paused by an application, shown
in the following values: 旼컴컴컴컴컴컴컴컴컴컴컴컴컴컴쩡컴컴컴쩡컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴커
� SYMBOLIC CONSTANT � VALUE � MEANING �
쳐컴컴컴컴컴컴컴컴컴컴컴컴컴컴탠컴컴컴탠컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴캑
� SERVICE_NOT_PAUSABLE � 0x00 � Service cannot be paused. �
쳐컴컴컴컴컴컴컴컴컴컴컴컴컴컴탠컴컴컴탠컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴캑
� SERVICE_PAUSABLE � 0x20 � Service can be paused. �
읕컴컴컴컴컴컴컴컴컴컴컴컴컴컴좔컴컴컴좔컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴켸
Bits 6 and 7 are reserved, with a value of 0.
Bits 8-10 indicate whether particular tasks within the Requester service
have been paused, shown by the following values: 旼컴컴컴컴컴컴컴컴컴컴컴컴컴컴쩡컴컴컴쩡컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴커
� SYMBOLIC CONSTANT � VALUE � MEANING �
쳐컴컴컴컴컴컴컴컴컴컴컴컴컴컴탠컴컴컴탠컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴캑
� SERVICE_REDIR_DISK_PAUSED � 0x100 � Redirector for disks paused.
�
쳐컴컴컴컴컴컴컴컴컴컴컴컴컴컴탠컴컴컴탠컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴캑
� SERVICE_REDIR_PRINT_PAUSED � 0x200 � Redirector for spooled devices paused.
�
쳐컴컴컴컴컴컴컴컴컴컴컴컴컴컴탠컴컴컴탠컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴캑
� SERVICE_REDIR_COMM_PAUSED � 0x400 � Redirector for serial devices paused.
�
쳐컴컴컴컴컴컴컴컴컴컴컴컴컴컴탠컴컴컴탠컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴캑
� SERVICE_REDIR_PAUSED � 0x700 � Redirector paused/active. �
읕컴컴컴컴컴컴컴컴컴컴컴컴컴컴좔컴컴컴좔컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴켸
The SERVICE.H header file defines low-word values for svcs_code as
follows: 旼컴컴컴컴컴컴컴컴컴컴컴컴컴컴쩡컴컴컴쩡컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴커
� SYMBOLIC CONSTANT � VALUE � MEANING �
쳐컴컴컴컴컴컴컴컴컴컴컴컴컴컴탠컴컴컴탠컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴캑
� SERVICE_UIC_M_NULL � 0 � Normal. �
쳐컴컴컴컴컴컴컴컴컴컴컴컴컴컴탠컴컴컴탠컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴캑
� SERVICE_UIC_M_MEMORY � 3070 � Insufficient memory. �
쳐컴컴컴컴컴컴컴컴컴컴컴컴컴컴탠컴컴컴탠컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴캑
� SERVICE_UIC_M_DISK � 3071 � Insufficient disk space. �
쳐컴컴컴컴컴컴컴컴컴컴컴컴컴컴탠컴컴컴탠컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴캑
� SERVICE_UIC_M_THREADS � 3072 � Unable to create thread. �
쳐컴컴컴컴컴컴컴컴컴컴컴컴컴컴탠컴컴컴탠컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴캑
� SERVICE_UIC_M_PROCESSES � 3073 � Unable to create process. �
쳐컴컴컴컴컴컴컴컴컴컴컴컴컴컴탠컴컴컴탠컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴캑
� SERVICE_UIC_M_SECURITY � 3074 � Security failure. �
쳐컴컴컴컴컴컴컴컴컴컴컴컴컴컴탠컴컴컴탠컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴캑
� SERVICE_UIC_M_LANROOT � 3075 � Incorrect or missing default path.
�
쳐컴컴컴컴컴컴컴컴컴컴컴컴컴컴탠컴컴컴탠컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴캑
� SERVICE_UIC_M_REDIR � 3076 � Network software not started. �
쳐컴컴컴컴컴컴컴컴컴컴컴컴컴컴탠컴컴컴탠컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴캑
� SERVICE_UIC_M_SERVER � 3077 � Server software not started. �
쳐컴컴컴컴컴컴컴컴컴컴컴컴컴컴탠컴컴컴탠컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴캑
� SERVICE_UIC_M_SEC_FILE_ERR � 3078 � Server could not access UAS database.
�
쳐컴컴컴컴컴컴컴컴컴컴컴컴컴컴탠컴컴컴탠컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴캑
� SERVICE_UIC_M_FILES � 3079 � Not supported. �
쳐컴컴컴컴컴컴컴컴컴컴컴컴컴컴탠컴컴컴탠컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴캑
� SERVICE_UIC_M_LOGS � 3080 � \IBMLAN\LOGS directory not valid.
�
쳐컴컴컴컴컴컴컴컴컴컴컴컴컴컴탠컴컴컴탠컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴캑
� SERVICE_UIC_M_LANGROUP � 3081 � Domain specified could not be used.
�
쳐컴컴컴컴컴컴컴컴컴컴컴컴컴컴탠컴컴컴탠컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴캑
� SERVICE_UIC_M_MSGNAME � 3082 � Computer name is being used as a
�
� � � message name on another computer. �
쳐컴컴컴컴컴컴컴컴컴컴컴컴컴컴탠컴컴컴탠컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴캑
� SERVICE_UIC_M_ANNOUNCE � 3083 � Requester did not announce the server
�
� � � name. �
쳐컴컴컴컴컴컴컴컴컴컴컴컴컴컴탠컴컴컴탠컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴캑
� SERVICE_UIC_M_UAS � 3084 � The UAS database is not configured �
� � � correctly. �
읕컴컴컴컴컴컴컴컴컴컴컴컴컴컴좔컴컴컴좔컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴켸
When the high-word value is SERVICE_UIC_CONFIG (numeric value of 3055),
the low-word value can be one of the following: 旼컴컴컴컴컴컴컴컴컴컴컴컴컴컴쩡컴컴컴쩡컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴커
� SYMBOLIC CONSTANT � VALUE � MEANING �
쳐컴컴컴컴컴컴컴컴컴컴컴컴컴컴탠컴컴컴탠컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴캑
� SERVICE_UIC_M_SERVER_SEC_ERR� 3085 � Server is not running with user-level
�
� � � security. �
쳐컴컴컴컴컴컴컴컴컴컴컴컴컴컴탠컴컴컴탠컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴캑
� SERVICE_UIC_M_WKSTA � 3087 � The requester detected a problem with
�
� � � the cable connection. �
쳐컴컴컴컴컴컴컴컴컴컴컴컴컴컴탠컴컴컴탠컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴캑
� SERVICE_UIC_M_ERRLOG � 3088 � View your error log (NET.ERR) for
�
� � � details. �
쳐컴컴컴컴컴컴컴컴컴컴컴컴컴컴탠컴컴컴탠컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴캑
� SERVICE_UIC_M_LAZY � 3091 � The 386 server cannot be started �
� � � because CACHE386.EXE is not running. �
읕컴컴컴컴컴컴컴컴컴컴컴컴컴컴좔컴컴컴좔컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴켸
In the case of a pending service start or stop (SERVICE_INSTALL_PENDING
or SERVICE_UNINSTALL_PENDING for the svcs_status field), svcs_code
serves as a bit-map mask providing information about that pending service.
The SERVICE.H header file defines this bit mask for svcs_code as
follows: 旼컴컴쩡컴컴컴컴컴컴컴컴컴컴컴컫컴컴컴컫컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴커
� BITS� START PENDING CODE � BIT � MEANING �
� � � MASK � �
쳐컴컴탠컴컴컴컴컴컴컴컴컴컴컴컵컴컴컴컵컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴캑
� 0-7 � SERVICE_CCP_NO_HINT � 0x0 � No reason given for start pending.
�
� � SERVICE_IP_NO_HINT � � �
쳐컴컴탠컴컴컴컴컴컴컴컴컴컴컴컵컴컴컴컵컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴캑
� 0-7 � SERVICE_CCP_CHKPT_NUM � 0xFF � Checkpoint number incremented each
�
� � SERVICE_IP_CHKPT_NUM � � time the service calls the �
� � � � NetServiceStatus API (Installer �
� � � � assumes incrementing denotes a valid �
� � � � service.) �
쳐컴컴탠컴컴컴컴컴컴컴컴컴컴컴컵컴컴컴컵컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴캑
� 8-15� SERVICE_CCP_WAIT_TIME � 0xFF00� Time to wait; expected time (tenths
�
� � SERVICE_IP_WAIT_TIME � � of a second) to start install or to �
� � � � stop install. �
쳐컴컴탠컴컴컴컴컴컴컴컴컴컴컴컵컴컴컴컵컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴캑
� 16 � SERVICE_CCP_QUERY_HINT � 0x1000� Reason given for start or stop
�
� � SERVICE_IP_QUERY_HINT � � pending. �
쳐컴컴탠컴컴컴컴컴컴컴컴컴컴컴컵컴컴컴컵컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴캑
� 17-3� - � - � Reserved; must be
0. �
읕컴컴좔컴컴컴컴컴컴컴컴컴컴컴컨컴컴컴컨컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴켸