SERVICE_REQUIRED_PRIVILEGES_INFOA Struktur (winsvc.h)
Stellt die erforderlichen Berechtigungen für einen Dienst dar.
Syntax
typedef struct _SERVICE_REQUIRED_PRIVILEGES_INFOA {
LPSTR pmszRequiredPrivileges;
} SERVICE_REQUIRED_PRIVILEGES_INFOA, *LPSERVICE_REQUIRED_PRIVILEGES_INFOA;
Angehörige
pmszRequiredPrivileges
Eine mehrfache Zeichenfolge, die die Berechtigungen angibt. Eine Liste der möglichen Werte finden Sie unter Berechtigungskonstanten.
Eine mehrfache Zeichenfolge ist eine Abfolge von Zeichenfolgen, die durch eine leere Zeichenfolge (\0) beendet werden. Es folgt ein Beispiel: String1\0String2\0String3\0LastString\0\0.
Bemerkungen
Die Änderung der erforderlichen Berechtigungen wird wirksam, wenn der Dienst das nächste Mal gestartet wird. Der SCM bestimmt, ob der Dienst die angegebenen Berechtigungen unterstützen kann, wenn er versucht, den Dienst zu starten.
Es empfiehlt sich, Ihren Dienst zu analysieren und den minimalen Satz von Berechtigungen zu verwenden, die erforderlich sind.
Wenn Sie die erforderlichen Berechtigungen nicht festlegen, verwendet SCM standardmäßig alle Berechtigungen, die dem Prozesstoken zugewiesen sind. Wenn Sie Berechtigungen für einen Dienst angeben, entfernt SCM die Berechtigungen, die beim Starten des Prozesses nicht vom Prozesstoken benötigt werden. Wenn mehrere Dienste einen Prozess gemeinsam nutzen, berechnet das SCM die Vereinigung von Berechtigungen, die von allen Diensten im Prozess benötigt werden.
Aus Gründen der Kompatibilität wird das SeChangeNotifyPrivilege-Privileg nie aus einem Prozesstoken entfernt, auch wenn kein Dienst im Prozess die Berechtigung angefordert hat. Daher muss ein Dienst diese Berechtigung nicht explizit angeben.
Anmerkung
Der winsvc.h-Header definiert SERVICE_REQUIRED_PRIVILEGES_INFO 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 Vista [nur Desktop-Apps] |
| mindestens unterstützte Server- | Windows Server 2008 [Nur Desktop-Apps] |
| Header- | winsvc.h (enthalten Windows.h) |