Función ResUtilSetResourceServiceEnvironment (resapi.h)

Ajusta los datos de entorno de un servicio para que el servicio use un nombre de red de clúster para identificar su ubicación. Se debe llamar a esta función desde un archivo DLL de recursos. El tipo PRESUTIL_SET_RESOURCE_SERVICE_ENVIRONMENT define un puntero a esta función.

Sintaxis

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

Parámetros

[in] pszServiceName

Puntero a una cadena Unicode terminada en null que contiene el nombre del servicio.

[in] hResource

Identificador de recursos para el servicio obtenido de OpenClusterResource.

[in] pfnLogEvent

Puntero a la función de punto de entrada LogEvent del archivo DLL de recursos que administra el servicio.

[in] hResourceHandle

Identificador de recursos requerido por la función de punto de entrada LogEvent . Use el identificador pasado al archivo DLL en la función Abrir punto de entrada.

Valor devuelto

Si la operación se realiza correctamente, la función devuelve ERROR_SUCCESS.

Si se produce un error en la operación, la función devuelve un código de error del sistema.

Comentarios

ResUtilSetResourceServiceEnvironment llama a ResUtilGetEnvironmentWithNetName y almacena el bloque de entorno resultante en una entrada del Registro para el servicio. Para obtener más información sobre los efectos del bloque de entorno, vea ResUtilGetEnvironmentWithNetName.

Si el archivo DLL de recursos administra un servicio, cree un subproceso de trabajo y use ResUtilSetResourceServiceStartParameters y ResUtilSetResourceServiceEnvironment al poner el servicio en línea.

No llame a ResUtilSetResourceServiceEnvironment desde cualquier función de punto de entrada dll de recursos. Se puede llamar a ResUtilSetResourceServiceEnvironment de forma segura desde un subproceso de trabajo. Para obtener más información, consulte Llamadas de función para evitar en archivos DLL de recursos.

Requisitos

Requisito	Value
Cliente mínimo compatible	No se admite ninguno
Servidor mínimo compatible	Windows Server 2008 Enterprise, Windows Server 2008 Datacenter
Plataforma de destino	Windows
Encabezado	resapi.h
Library	ResUtils.lib
Archivo DLL	ResUtils.dll

Consulte también

ResUtilGetEnvironmentWithNetName