ENUM_SERVICE_STATUS_PROCESSA structure (winsvc.h)

  • Article

Contains the name of a service in a service control manager database and information about the service. It is used by the EnumServicesStatusEx function.

Syntax

typedef struct _ENUM_SERVICE_STATUS_PROCESSA {
  LPSTR                  lpServiceName;
  LPSTR                  lpDisplayName;
  SERVICE_STATUS_PROCESS ServiceStatusProcess;
} ENUM_SERVICE_STATUS_PROCESSA, *LPENUM_SERVICE_STATUS_PROCESSA;

Members

lpServiceName

The name of a service in the service control manager database. The maximum string length is 256 characters. The service control manager database preserves the case of the characters, but service name comparisons are always case insensitive. A slash (/), backslash (\), comma, and space are invalid service name characters.

lpDisplayName

A display name that can be used by service control programs, such as Services in Control Panel, to identify the service. This string has a maximum length of 256 characters. The case is preserved in the service control manager. Display name comparisons are always case-insensitive.

ServiceStatusProcess

A SERVICE_STATUS_PROCESS structure that contains status information for the lpServiceName service.

Remarks

Note

The winsvc.h header defines ENUM_SERVICE_STATUS_PROCESS as an alias which automatically selects the ANSI or Unicode version of this function based on the definition of the UNICODE preprocessor constant. Mixing usage of the encoding-neutral alias with code that not encoding-neutral can lead to mismatches that result in compilation or runtime errors. For more information, see Conventions for Function Prototypes.

Requirements

Requirement Value
Minimum supported client Windows XP [desktop apps only]
Minimum supported server Windows Server 2003 [desktop apps only]
Header winsvc.h (include Windows.h)

See also

EnumServicesStatusEx

SERVICE_STATUS_PROCESS