Función ResUtilEnumResourcesEx2 (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_EX2 define un puntero a esta función.
Sintaxis
DWORD ResUtilEnumResourcesEx2(
[in] HCLUSTER hCluster,
[in, optional] HRESOURCE hSelf,
[in] LPCWSTR lpszResTypeName,
[in] LPRESOURCE_CALLBACK_EX pResCallBack,
[in] PVOID pParameter,
[in] DWORD dwDesiredAccess
);
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 llamará 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
[in] El parámetro hCluster pasado a ResUtilEnumResourcesEx.
hSelf
[in] Parámetro hSelf pasado 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
[in] Identificador del recurso que se está enumerando actualmente. ResUtilEnumResourcesEx se abre y cierra este identificador automáticamente.
pParameter
[in] Un búfer genérico que permite pasar cualquier tipo de datos a la función de devolución de llamada.
[in] pParameter
Un 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.
[in] dwDesiredAccess
Privilegios de acceso solicitados. Puede ser cualquier combinación de GENERIC_READ (0x80000000), GENERIC_ALL (0x10000000) o MAXIMUM_ALLOWED (0x02000000). Si este valor es cero (0), se puede devolver un error indefinido. El uso de GENERIC_ALL es el mismo que llamar a ResUtilEnumResourcesEx.
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.
Requisitos
| Requisito | Value |
|---|---|
| Cliente mínimo compatible | No se admite ninguno |
| Servidor mínimo compatible | Windows Server 2012 |
| Plataforma de destino | Windows |
| Encabezado | resapi.h |
| Library | ResUtils.lib |
| Archivo DLL | ResUtils.dll |