ResUtilSetResourceServiceEnvironment-Funktion (resapi.h)
Passt die Umgebungsdaten für einen Dienst an, sodass der Dienst einen Clusternetzwerknamen verwendet, um seinen Standort zu identifizieren. Diese Funktion muss aus einer Ressourcen-DLL aufgerufen werden. Der PRESUTIL_SET_RESOURCE_SERVICE_ENVIRONMENT Typ definiert einen Zeiger auf diese Funktion.
Syntax
DWORD ResUtilSetResourceServiceEnvironment(
[in] LPCWSTR pszServiceName,
[in] HRESOURCE hResource,
[in] PLOG_EVENT_ROUTINE pfnLogEvent,
[in] RESOURCE_HANDLE hResourceHandle
);
Parameter
[in] pszServiceName
Zeiger auf eine mit NULL beendete Unicode-Zeichenfolge, die den Namen des Diensts enthält.
[in] hResource
Ressourcenhandle für den Dienst, der von OpenClusterResource abgerufen wurde.
[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
ResUtilSetResourceServiceEnvironment ruft ResUtilGetEnvironmentWithNetName auf und speichert den resultierenden Umgebungsblock in einem Registrierungseintrag für den Dienst. Weitere Informationen zu den Auswirkungen des Umgebungsblocks finden Sie unter ResUtilGetEnvironmentWithNetName.
Wenn Ihre Ressourcen-DLL einen Dienst verwaltet, erstellen Sie einen Workerthread, und verwenden Sie ResUtilSetResourceServiceStartParameters und ResUtilSetResourceServiceEnvironment , wenn Sie den Dienst online schalten.
Rufen Sie ResUtilSetResourceServiceEnvironment nicht über eine Ressourcen-DLL-Einstiegspunktfunktion auf. ResUtilSetResourceServiceEnvironment kann sicher über einen Workerthread aufgerufen werden. Weitere Informationen finden Sie unter Zu vermeidende Funktionsaufrufe in Ressourcen-DLLs.
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 |