Freigeben über

SERVICE_DESCRIPTIONA-Struktur (winsvc.h)

  • Artikel

Enthält eine Dienstbeschreibung.

Syntax

typedef struct _SERVICE_DESCRIPTIONA {
  LPSTR lpDescription;
} SERVICE_DESCRIPTIONA, *LPSERVICE_DESCRIPTIONA;

Member

lpDescription

Die Beschreibung des Dienstes. Wenn dieser Member NULL ist, bleibt die Beschreibung unverändert. Wenn es sich bei diesem Wert um eine leere Zeichenfolge ("") handelt, wird die aktuelle Beschreibung gelöscht.

Die Dienstbeschreibung darf die Größe eines Registrierungswerts vom Typ REG_SZ nicht überschreiten.

Dieses Member kann eine lokalisierte Zeichenfolge im folgenden Format angeben:

@[pfad]dllname,-strID

Die Zeichenfolge mit dem Bezeichner strID wird aus dllname geladen. der Pfad ist optional. Weitere Informationen finden Sie unter RegLoadMUIString.

Windows Server 2003 und Windows XP: Lokalisierte Zeichenfolgen werden erst unter Windows Vista unterstützt.

Hinweise

Eine Beschreibung von NULL gibt an, dass keine Dienstbeschreibung vorhanden ist. Die Dienstbeschreibung ist NULL, wenn der Dienst erstellt wird.

Die Beschreibung ist einfach ein Kommentar, der den Zweck des Diensts erläutert. Für den DHCP-Dienst können Sie beispielsweise die Beschreibung "Stellt Internetadressen für Computer in Ihrem Netzwerk bereit".

Sie können die Beschreibung mithilfe der ChangeServiceConfig2-Funktion festlegen. Sie können die Beschreibung mithilfe der Funktion QueryServiceConfig2 abrufen. Die Beschreibung wird auch vom Snap-In Dienste angezeigt.

Beispiele

Ein Beispiel finden Sie unter Ändern der Konfiguration eines Diensts oder Abfragen der Konfiguration eines Diensts.

Hinweis

Der winsvc.h-Header definiert SERVICE_DESCRIPTION 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 nicht codierungsneutralem Code 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 (einschließen von Windows.h)

Weitere Informationen

ChangeServiceConfig2

QueryServiceConfig2