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

Weitere Informationen

ResUtilGetEnvironmentWithNetName