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 |