Funzione ResUtilSetResourceServiceEnvironment (resapi.h)

Articolo
03/01/2024

Regola i dati dell'ambiente per un servizio in modo che il servizio usi un nome di rete del cluster per identificarne la posizione. Questa funzione deve essere chiamata da una DLL di risorse. Il tipo PRESUTIL_SET_RESOURCE_SERVICE_ENVIRONMENT definisce un puntatore a questa funzione.

Sintassi

DWORD ResUtilSetResourceServiceEnvironment(
  [in] LPCWSTR            pszServiceName,
  [in] HRESOURCE          hResource,
  [in] PLOG_EVENT_ROUTINE pfnLogEvent,
  [in] RESOURCE_HANDLE    hResourceHandle
);

Parametri

[in] pszServiceName

Puntatore a una stringa Unicode con terminazione Null contenente il nome del servizio.

[in] hResource

Handle di risorsa per il servizio ottenuto da OpenClusterResource.

[in] pfnLogEvent

Puntatore alla funzione del punto di ingresso LogEvent della DLL della risorsa che gestisce il servizio.

[in] hResourceHandle

Handle di risorsa richiesto dalla funzione del punto di ingresso LogEvent . Usare l'handle passato alla DLL nella funzione Punto di ingresso Aperto.

Valore restituito

Se l'operazione ha esito positivo, la funzione restituisce ERROR_SUCCESS.

Se l'operazione non riesce, la funzione restituisce un codice di errore di sistema.

Commenti

ResUtilSetResourceServiceEnvironment chiama ResUtilGetEnvironmentWithNetName e archivia il blocco di ambiente risultante in una voce del Registro di sistema per il servizio. Per altre informazioni sugli effetti del blocco di ambiente, vedere ResUtilGetEnvironmentWithNetName.

Se la DLL della risorsa gestisce un servizio, creare un thread di lavoro e usare ResUtilSetResourceServiceStartParameters e ResUtilSetResourceServiceEnvironment quando si porta il servizio online.

Non chiamare ResUtilSetResourceServiceEnvironment da qualsiasi funzione del punto di ingresso della DLL di risorse. ResUtilSetResourceServiceEnvironment può essere chiamato in modo sicuro da un thread di lavoro. Per altre informazioni, vedere Chiamate di funzione da evitare nelle DLL delle risorse.

Requisiti

Requisito	Valore
Client minimo supportato	Nessuno supportato
Server minimo supportato	Windows Server 2008 Enterprise, Windows Server 2008 Datacenter
Piattaforma di destinazione	Windows
Intestazione	resapi.h
Libreria	ResUtils.lib
DLL	ResUtils.dll

Vedi anche

ResUtilGetEnvironmentWithNetName

Condividi tramite