ResUtilSetResourceServiceStartParametersEx-Funktion (resapi.h)
Passt die Startparameter eines angegebenen Diensts so an, dass er ordnungsgemäß als Clusterressource ausgeführt wird. Sie muss aus einer Ressourcen-DLL aufgerufen werden. Der PRESUTIL_SET_RESOURCE_SERVICE_START_PARAMETERS_EX Typ definiert einen Zeiger auf diese Funktion.
Syntax
DWORD ResUtilSetResourceServiceStartParametersEx(
[in] LPCWSTR pszServiceName,
[in] SC_HANDLE schSCMHandle,
[in, out] LPSC_HANDLE phService,
[in] DWORD dwDesiredAccess,
[in] PLOG_EVENT_ROUTINE pfnLogEvent,
[in] RESOURCE_HANDLE hResourceHandle
);
Parameter
[in] pszServiceName
Ein Zeiger auf eine Unicode-Zeichenfolge mit Null-Beendigung, die den Namen des Diensts angibt.
[in] schSCMHandle
Ein Handle für den Dienststeuerungs-Manager (SCM) oder NULL. Bei NULL versucht die Funktion, ein Handle für den SCM zu öffnen.
[in, out] phService
Bei der Eingabe ein NULL-Diensthandle . Behandeln Sie bei der Ausgabe den angegebenen Dienst, wenn der Aufruf erfolgreich war. andernfalls NULL.
[in] dwDesiredAccess
Die angeforderten Zugriffsberechtigungen. Dies kann eine kombination aus GENERIC_READ (0x80000000), GENERIC_ALL (0x10000000) oder MAXIMUM_ALLOWED (0x02000000) sein. Wenn dieser Wert null (0) ist, wird möglicherweise ein nicht definierter Fehler zurückgegeben. Die Verwendung GENERIC_ALL ist identisch mit dem Aufrufen von ResUtilSetResourceServiceStartParameters.
[in] pfnLogEvent
Ein Zeiger auf die LogEvent-Einstiegspunktfunktion der Ressourcen-DLL, die den Dienst verwaltet.
[in] hResourceHandle
Ein Ressourcenhandle, das für die LogEvent-Einstiegspunktfunktion erforderlich ist. Verwenden Sie das Handle, das in der Open-Einstiegspunktfunktion an die DLL übergeben wird.
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.
Hinweise
ResUtilSetResourceServiceStartParametersEx überprüft, ob der Dienst nicht deaktiviert ist, ändert die Dienstkonfiguration in manuelles Starten und verhindert, dass der Dienst als Reaktion auf einen Fehler neu gestartet wird. Dadurch können der Cluster und die Ressourcen-DLL den Dienst steuern.
Wenn Ihre Ressourcen-DLL einen Dienst verwaltet, verwenden Sie ResUtilSetResourceServiceStartParametersEx und ResUtilSetResourceServiceEnvironment , bevor Sie den Dienst online schalten.
Anforderungen
| Anforderung | Wert |
|---|---|
| Unterstützte Mindestversion (Client) | Nicht unterstützt |
| Unterstützte Mindestversion (Server) | Windows Server 2012 |
| Zielplattform | Windows |
| Kopfzeile | resapi.h |
| Bibliothek | ResUtils.lib |
| DLL | ResUtils.dll |