ICOMAdminCatalog::ServiceCheck method (comadmin.h)

Retrieves the current status of the specified COM+ service.

Syntax

HRESULT ServiceCheck(
  [in]          long lService,
  [out, retval] long *plStatus
);

Parameters

[in] lService

The service for which status is to be checked. This parameter can be COMAdminServiceLoadBalanceRouter (1) to check the component load balancing service.

[out, retval] plStatus

The status for the specified service.

Value Meaning
COMAdminServiceStopped
0
The service is stopped.
COMAdminServiceStartPending
1
The service is due to start.
COMAdminServiceStopPending
2
The service is due to stop.
COMAdminServiceRunning
3
The service is running.
COMAdminServiceContinuePending
4
The service is due to continue.
COMAdminServicePausePending
5
The service is due to pause.
COMAdminServicePaused
6
The service is paused.
COMAdminServiceUnknownState
7
The service status is unknown.

Return value

This method can return the standard return values E_INVALIDARG, E_OUTOFMEMORY, E_UNEXPECTED, E_FAIL, and S_OK.

Requirements

Requirement Value
Minimum supported client Windows 2000 Professional [desktop apps only]
Minimum supported server Windows 2000 Server [desktop apps only]
Target Platform Windows
Header comadmin.h

See also

ICOMAdminCatalog