NetServiceStatus or Net32ServiceStatus

The NetServiceStatus API sets status and code information for a network service.

Restrictions

A call to this API must be issued locally. This API can be called only from an OS/2 workstation.

#include <netcons.h>
#include <service.h>
 
NetServiceStatus(buf, ulBuflen);      /*32 bit*/

See Common Parameter Definitions for descriptions of parameters not defined here.

buf

(unsigned char LSFAR *) points to the data structure to be passed with this API call, described in Service Status Data Structure.

The following table lists the return codes most significant to this API. (See API Return Codes for a complete list of return codes.) кФФФФФФФФФФФФФФФФФФФФФФФФФФФТФФФФФФФТФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФПГSYMBOLICCONSTANT ГVALUEГMEANING Г
УФФФФФФФФФФФФФФФФФФФФФФФФФФФХФФФФФФФХФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФД
Г NERR_Success Г 0 Г No errors were encountered. Г
УФФФФФФФФФФФФФФФФФФФФФФФФФФФХФФФФФФФХФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФД
Г NERR_NetNotStarted Г 2102 Г The redirector NETWKSTA.200 has not been Г
Г Г Г started. Г
УФФФФФФФФФФФФФФФФФФФФФФФФФФФХФФФФФФФХФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФД
Г NERR_BufTooSmall Г 2123 Г The buffer is too small for fixed-length Г
Г Г Г data. Г
УФФФФФФФФФФФФФФФФФФФФФФФФФФФХФФФФФФФХФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФД
Г NERR_WkstaNotStarted Г 2138 Г The Requester service has not been Г
Г Г Г started. Г
УФФФФФФФФФФФФФФФФФФФФФФФФФФФХФФФФФФФХФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФД
Г NERR_ServiceTableLocked Г 2180 Г The service does not respond to control Г
Г Г Г actions. Г
УФФФФФФФФФФФФФФФФФФФФФФФФФФФХФФФФФФФХФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФД
Г NERR_ServiceNotInstalled Г 2184 Г The service has not been started. Г
РФФФФФФФФФФФФФФФФФФФФФФФФФФФСФФФФФФФСФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФй

Other codes could be returned from the following functions:

DosGetInfoSeg
DosGetShrSeg

Service applications must call the NetServiceStatus API to update their status and code tables each time their status changes.

If a nonservice application (one not started by a call to the NetServiceInstall API) calls the NetServiceStatus API, the NetServiceStatus API returns the NERR_ServiceNotInstalled error code.

For information about controlling the operation of a network service, see Services - NetServiceControl.

[Back]

[Next]