ResUtilTerminateServiceProcessFromResDll-Funktion (resapi.h)
Versucht, den Prozess eines Diensts zu beenden, der als Clusterressource von einer Ressourcen-DLL verwaltet wird. Der PRESUTIL_TERMINATE_SERVICE_PROCESS_FROM_RES_DLL Typ definiert einen Zeiger auf diese Funktion.
Syntax
DWORD ResUtilTerminateServiceProcessFromResDll(
[in] DWORD dwServicePid,
[in] BOOL bOffline,
[out, optional] PDWORD pdwResourceState,
[in] PLOG_EVENT_ROUTINE pfnLogEvent,
[in] RESOURCE_HANDLE hResourceHandle
);
Parameter
[in] dwServicePid
Die Prozess-ID des zu beendenden Dienstprozesses.
[in] bOffline
Gibt an, ob die Ressource offline geschaltet wird oder beendet wird. Geben Sie TRUE an, wenn Sie vom Offlineeinstiegspunkt oder von einem Workerthread aufrufen, der erstellt wurde, um die Ressource offline zu schalten. Andernfalls geben Sie FALSE an, und die Funktion geht davon aus, dass Sie die Ressource beenden.
[out, optional] pdwResourceState
Optionaler Zeiger auf ein DWORD , das den resultierenden Zustand der Ressource zurückgibt, der entweder ClusterResourceFailed oder ClusterResourceOffline ist (eine vollständige Liste der Ressourcenzustände finden Sie unter GetClusterResourceState). Übergeben Sie NULL , wenn Sie diese Informationen nicht benötigen.
[in] pfnLogEvent
Zeiger auf die LogEvent-Funktion , die von Ihrer Ressourcen-DLL verwendet wird. Dieser Zeiger wird am Startpunkt an Ihre Ressourcen-DLL übergeben.
[in] hResourceHandle
Das Handle des Ressourcenmonitors für die Ressource. Dieses Handle wird an Ihre Ressourcen-DLL im Einstiegspunkt Öffnen übergeben und muss als Teil der instance Daten der Ressource gespeichert 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.
Beachten Sie, dass ResUtilTerminateServiceProcessFromResDllpfnLogEvent und hResourceHandle verwendet, um in das Ereignisprotokoll Ihrer Ressourcen-DLL zu schreiben, wodurch Fehler behoben werden können.
Hinweise
Sie sollten ResUtilTerminateServiceProcessFromResDll nur beim Beenden einer Ressource oder beim Offline schalten einer Ressource aufrufen.
Anforderungen
| Anforderung | Wert |
|---|---|
| Unterstützte Mindestversion (Client) | Nicht unterstützt |
| Unterstützte Mindestversion (Server) | Windows Server 2008 Datacenter, Windows Server 2008 Enterprise |
| Zielplattform | Windows |
| Kopfzeile | resapi.h |
| Bibliothek | ResUtils.lib |
| DLL | ResUtils.dll |