Función ClusterResourceTypeEnum (clusapi.h)

Artículo
08/22/2023

Enumera los posibles nodos o recursos de propietario de un tipo de recurso, devolviendo el nombre de un nodo o recurso por llamada. El tipo PCLUSAPI_CLUSTER_RESOURCE_TYPE_ENUM define un puntero a esta función.

Sintaxis

DWORD ClusterResourceTypeEnum(
  [in]      HRESTYPEENUM hResTypeEnum,
  [in]      DWORD        dwIndex,
  [out]     LPDWORD      lpdwType,
  [out]     LPWSTR       lpszName,
  [in, out] LPDWORD      lpcchName
);

Parámetros

[in] hResTypeEnum

Identificador de enumeración de tipo de recurso devuelto desde ClusterResourceTypeOpenEnum.

[in] dwIndex

Índice del objeto de recurso o nodo que se va a devolver. Este parámetro debe ser cero para la primera llamada a ClusterResourceTypeEnum y, a continuación, incrementarse para las llamadas posteriores.

[out] lpdwType

Tipo de objeto devuelto por ClusterResourceTypeEnum. Los siguientes valores de la enumeración CLUSTER_RESOURCE_TYPE_ENUM son válidos.

CLUSTER_RESOURCE_TYPE_ENUM_NODES (1)

El objeto es un nodo que puede ser un posible propietario del tipo de recurso.

CLUSTER_RESOURCE_TYPE_ENUM_RESOURCES (2)

El objeto es un recurso que es una instancia del tipo de recurso.

[out] lpszName

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

[in, out] lpcchName

Puntero al tamaño del búfer lpszName como recuento de caracteres. En la entrada, especifique el número máximo de caracteres que puede contener el búfer, incluido el valor NULL de terminación. En la salida, especifica el número de caracteres en el nombre resultante, excepto el valor NULL de terminación.

Valor devuelto

La función devuelve uno de los valores siguientes.

Código o valor devuelto	Descripción
ERROR_SUCCESS 0	La operación se realizó correctamente.
ERROR_NO_MORE_ITEMS 259	No hay más objetos que se van a devolver.
ERROR_MORE_DATA 234	El búfer al que apunta lpszName no es lo suficientemente grande como para contener el resultado. El parámetro lpcchName devuelve el número de caracteres del resultado, excepto el valor NULL de terminación.
Código de error del sistema	Error en la operación.

Comentarios

Tenga en cuenta que lpcchName hace referencia a un recuento de caracteres y no a un recuento de bytes, y que el tamaño devuelto no incluye el valor NULL de terminación en el recuento. Para obtener más información sobre los búferes de tamaño, consulte Convenciones de tamaño de datos.

Ejemplos

Vea Enumerar objetos.

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	clusapi.h
Library	ClusAPI.lib
Archivo DLL	ClusAPI.dll