Freigeben über


ResUtilStartResourceService-Funktion (resapi.h)

Startet einen Dienst. Der PRESUTIL_START_RESOURCE_SERVICE Typ definiert einen Zeiger auf diese Funktion.

Syntax

DWORD ResUtilStartResourceService(
  [in]  LPCWSTR     pszServiceName,
  [out] LPSC_HANDLE phServiceHandle
);

Parameter

[in] pszServiceName

Unicode-Zeichenfolge mit Null-Endung, die den Namen des zu startenden Diensts enthält.

[out] phServiceHandle

Optionaler Zeiger auf ein Handle, in dem das Handle an den gestarteten Dienst zurückgegeben wird. Dieses Handle muss entweder durch einen Aufruf der Clusterhilfsprogrammfunktion ResUtilStopService oder der Funktion CloseServiceHandle geschlossen werden.

Rückgabewert

Wenn der Vorgang erfolgreich ist, gibt die Funktion ERROR_SUCCESS zurück.

Wenn der Vorgang fehlschlägt, gibt die Funktion einen Systemfehlercode zurück. Im Folgenden ist ein möglicher Fehlercode aufgeführt.

Rückgabecode Beschreibung
ERROR_SERVICE_NEVER_STARTED
Der Dienst wurde nicht gestartet.

Hinweise

Die ResUtilStartResourceService-Hilfsprogrammfunktion kapselt die erforderlichen Aufrufe des Dienststeuerungs-Managers und bietet eine bequeme Möglichkeit zum Starten von Diensten im Cluster. Die Verwendung von ResUtilStartResourceService ist optional. Wenn der zu startende Dienst bestimmte Zugriffsbeschränkungen oder eine andere spezielle Behandlung erfordert, verwenden Sie stattdessen die Funktionen des Dienststeuerungs-Managers.

Anforderungen

Anforderung Wert
Unterstützte Mindestversion (Client) Nicht unterstützt
Unterstützte Mindestversion (Server) Windows Server 2008 Enterprise, Windows Server 2008 Datacenter
Zielplattform Windows
Kopfzeile resapi.h
Bibliothek ResUtils.lib
DLL ResUtils.dll

Weitere Informationen

ResUtilStopService