SERVICE_REQUIRED_PRIVILEGES_INFOW-Struktur (winsvc.h)

  • Artikel

Stellt die erforderlichen Berechtigungen für einen Dienst dar.

Syntax

typedef struct _SERVICE_REQUIRED_PRIVILEGES_INFOW {
  LPWSTR pmszRequiredPrivileges;
} SERVICE_REQUIRED_PRIVILEGES_INFOW, *LPSERVICE_REQUIRED_PRIVILEGES_INFOW;

Member

pmszRequiredPrivileges

Eine mehrfache Zeichenfolge, die die Berechtigungen angibt. Eine Liste der möglichen Werte finden Sie unter Berechtigungskonstanten.

Eine mehrfache Zeichenfolge ist eine Sequenz von NULL-Zeichenfolgen, die durch eine leere Zeichenfolge (\0) beendet wird. Im Folgenden finden Sie ein Beispiel: String1\0String2\0String3\0LastString\0\0.

Hinweise

Die Änderung der erforderlichen Berechtigungen wird beim nächsten Starten des Diensts wirksam. 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 minimal erforderlichen Satz von Berechtigungen zu verwenden.

Wenn Sie die erforderlichen Berechtigungen nicht festlegen, verwendet der SCM alle Berechtigungen, die dem Prozesstoken standardmäßig zugewiesen sind. Wenn Sie Berechtigungen für einen Dienst angeben, entfernt der SCM die Berechtigungen, die nicht aus dem Prozesstoken erforderlich sind, wenn der Prozess gestartet wird. Wenn mehrere Dienste einen Prozess gemeinsam nutzen, berechnet der SCM die Union der Berechtigungen, die für alle Dienste im Prozess erforderlich sind.

Aus Gründen der Kompatibilität wird die SeChangeNotifyPrivilege-Berechtigung niemals aus einem Prozesstoken entfernt, auch wenn kein Dienst im Prozess die Berechtigung angefordert hat. Daher muss ein Dienst diese Berechtigung nicht explizit angeben.

Hinweis

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

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

Weitere Informationen

ChangeServiceConfig2

QueryServiceConfig2