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

Weitere Informationen

LogEvent

Online

Öffnen

ResUtilSetResourceServiceEnvironment