Función ResUtilEnumResourcesEx (resapi.h)
Enumera todos los recursos de un clúster especificado e inicia una operación definida por el usuario para cada recurso. El tipo PRESUTIL_ENUM_RESOURCES_EX define un puntero a esta función.
Sintaxis
DWORD ResUtilEnumResourcesEx(
[in] HCLUSTER hCluster,
[in, optional] HRESOURCE hSelf,
[in] LPCWSTR lpszResTypeName,
[in] LPRESOURCE_CALLBACK_EX pResCallBack,
[in] PVOID pParameter
);
Parámetros
[in] hCluster
Identificador del clúster que contiene los recursos que se van a enumerar.
[in, optional] hSelf
Identificador opcional de un recurso de clúster. La función de devolución de llamada no se invoca para un recurso identificado por hSelf.
[in] lpszResTypeName
Puntero opcional a un nombre de un tipo de recurso que limita el ámbito de los recursos que se van a enumerar. Si se especifica lpszResTypeName , solo se enumeran los recursos del tipo especificado.
[in] pResCallBack
Puntero a una función definida por el usuario a la que se llama para cada recurso enumerado. Esta función debe cumplir la definición de la función de devolución de llamada ResourceCallbackEx . Tenga en cuenta que los nombres de parámetro no forman parte de la definición; se han agregado aquí para mayor claridad.
DWORD (*LPRESOURCE_CALLBACK_EX)(
HCLUSTER hCluster,
HRESOURCE hSelf,
HRESOURCE hEnum,
PVOID pParameter
);
hCluster
Parámetro hCluster que se pasa a ResUtilEnumResourcesEx.
hSelf
Parámetro hSelf que se pasa a ResUtilEnumResourcesEx. Tenga en cuenta que nunca se llama a la función de devolución de llamada cuando hSelf y hEnum hacen referencia al mismo recurso.
hEnum
Identificador del recurso que se está enumerando actualmente. ResUtilEnumResourcesEx se abre y cierra este identificador automáticamente.
pParameter
Búfer genérico que permite pasar cualquier tipo de datos a la función de devolución de llamada.
[in] pParameter
Búfer genérico que permite pasar cualquier tipo de datos a la función de devolución de llamada. ResUtilEnumResourcesEx no usa este parámetro en absoluto; simplemente pasa el puntero a la función de devolución de llamada. Si puede pasar NULL para el parámetro depende de cómo se implemente la función de devolución de llamada.
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 detiene inmediatamente la enumeración y devuelve el valor devuelto por la función de devolución de llamada.
Comentarios
ResUtilEnumResourcesEx es una alternativa cómoda y fácil de usar a la función ClusterResourceEnum .
Ejemplos
Consulte el ejemplo de ResUtilEnumResources.
Requisitos
| Requisito | Value |
|---|---|
| Cliente mínimo compatible | No se admite ninguno |
| Servidor mínimo compatible | Windows Server 2008 Datacenter, Windows Server 2008 Enterprise |
| Plataforma de destino | Windows |
| Encabezado | resapi.h |
| Library | ResUtils.lib |
| Archivo DLL | ResUtils.dll |