SERVICE_DESCRIPTIONA Struktur (winsvc.h)
Enthält eine Dienstbeschreibung.
Syntax
typedef struct _SERVICE_DESCRIPTIONA {
LPSTR lpDescription;
} SERVICE_DESCRIPTIONA, *LPSERVICE_DESCRIPTIONA;
Angehörige
lpDescription
Die Beschreibung des Diensts. Wenn dieses Element NULL-ist, bleibt die Beschreibung unverändert. Wenn dieser Wert eine leere Zeichenfolge ("") ist, wird die aktuelle Beschreibung gelöscht.
Die Dienstbeschreibung darf die Größe eines Registrierungswerts vom Typ REG_SZnicht überschreiten.
Dieser Member kann eine lokalisierte Zeichenfolge mit dem folgenden Format angeben:
@[Pfad]dllname,-strID
Die Zeichenfolge mit bezeichner strID wird aus dllnamegeladen; der Pfad optional ist. Weitere Informationen finden Sie unter RegLoadMUIString.
Windows Server 2003 und Windows XP: Lokalisierte Zeichenfolgen werden erst unter Windows Vista unterstützt.
Bemerkungen
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 Dienstes erläutert. Beispielsweise können Sie für den DHCP-Dienst 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 QueryServiceConfig2--Funktion abrufen. Die Beschreibung wird auch vom Services-Snap-In angezeigt.
Beispiele
Ein Beispiel finden Sie unter Ändern der Konfigurations- oder Abfragen der Konfigurations-eines Diensts.
Anmerkung
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 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
| Anforderung | Wert |
|---|---|
| mindestens unterstützte Client- | Windows XP [nur Desktop-Apps] |
| mindestens unterstützte Server- | Windows Server 2003 [Nur Desktop-Apps] |
| Header- | winsvc.h (enthalten Windows.h) |