ENUM_SERVICE_STATUSA-Struktur (winsvc.h)

Artikel
08/27/2023

Enthält den Namen eines Diensts in einer Dienststeuerungs-Manager-Datenbank und Informationen zu diesem Dienst. Sie wird von den Funktionen EnumDependentServices und EnumServicesStatus verwendet.

Syntax

typedef struct _ENUM_SERVICE_STATUSA {
  LPSTR          lpServiceName;
  LPSTR          lpDisplayName;
  SERVICE_STATUS ServiceStatus;
} ENUM_SERVICE_STATUSA, *LPENUM_SERVICE_STATUSA;

Member

lpServiceName

Der Name eines Diensts in der Dienststeuerungs-Manager-Datenbank. Die maximale Zeichenfolgenlänge beträgt 256 Zeichen. Die Datenbank des Dienststeuerungs-Managers behält die Groß-/Kleinschreibung der Zeichen bei, bei Dienstnamenvergleichen wird jedoch immer die Groß-/Kleinschreibung nicht beachtet. Schrägstrich (/), umgekehrter Schrägstrich (\), Komma und Leerzeichen sind ungültige Dienstnamenzeichen.

lpDisplayName

Ein Anzeigename, der von Dienststeuerungsprogrammen wie Diensten in Systemsteuerung verwendet werden kann, um den Dienst zu identifizieren. Die maximale Länge der Zeichenfolge beträgt 256 Zeichen. Der Name wird im Dienststeuerungs-Manager in Groß-/Kleinschreibung beibehalten. Bei Anzeigenamenvergleichen wird immer zwischen Groß- und Kleinschreibung unterschieden.

ServiceStatus

Eine SERVICE_STATUS-Struktur, die status Informationen für den lpServiceName-Dienst enthält.

Hinweise

Hinweis

Der winsvc.h-Header definiert ENUM_SERVICE_STATUS als Alias, der die ANSI- oder Unicode-Version dieser Funktion basierend auf der Definition der UNICODE-Präprozessorkonstante automatisch auswählt. Das Mischen der Verwendung des codierungsneutralen Alias mit Code, der nicht Codierungsneutral ist, kann zu Nichtübereinstimmungen führen, die zu Kompilierungs- oder Laufzeitfehlern führen. Weitere Informationen finden Sie unter Konventionen für Funktionsprototypen.

Anforderungen


Unterstützte Mindestversion (Client)	Windows XP [nur Desktop-Apps]
Unterstützte Mindestversion (Server)	Windows Server 2003 [nur Desktop-Apps]
Kopfzeile	winsvc.h (windows.h einschließen)

Weitere Informationen

EnumDependentServices

EnumServicesStatus

SERVICE_STATUS

Freigeben über