ResUtilSetResourceServiceStartParameters-Funktion (resapi.h)
Passt die Startparameter eines angegebenen Diensts an, sodass er ordnungsgemäß als Clusterressource ausgeführt wird. Sie muss aus einer Ressourcen-DLL aufgerufen werden. Der PRESUTIL_SET_RESOURCE_SERVICE_START_PARAMETERS-Typs definiert einen Zeiger auf diese Funktion.
Syntax
DWORD ResUtilSetResourceServiceStartParameters(
[in] LPCWSTR pszServiceName,
[in] SC_HANDLE schSCMHandle,
[in, out] LPSC_HANDLE phService,
[in] PLOG_EVENT_ROUTINE pfnLogEvent,
[in] RESOURCE_HANDLE hResourceHandle
);
Parameter
[in] pszServiceName
Zeiger auf eine Unicode-Zeichenfolge mit NULL-Beendigung, die den Namen des Diensts angibt.
[in] schSCMHandle
Behandeln Sie 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] pfnLogEvent
Zeiger auf die LogEvent-Einstiegspunktfunktion der Ressourcen-DLL, die den Dienst verwaltet.
[in] hResourceHandle
Ressourcenhandle, die für die LogEvent-Einstiegspunktfunktion erforderlich ist. Verwenden Sie das Handle, das an die DLL in der Open-Einstiegspunktfunktion übergeben wurde.
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
ResUtilSetResourceServiceStartParameters überprüft, ob der Dienst nicht deaktiviert ist, ändert die Dienstkonfiguration in manuellen Start 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 ResUtilSetResourceServiceStartParameters und ResUtilSetResourceServiceEnvironment , bevor Sie den Dienst online schalten.
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 |