Compartir a través de

Función ResUtilGetAllProperties (resapi.h)

  • Artículo

Devuelve una lista de propiedades que incluye todas las propiedades predeterminadas y desconocidas de un objeto de clúster. El tipo PRESUTIL_GET_ALL_PROPERTIES define un puntero a esta función.

Sintaxis

DWORD ResUtilGetAllProperties(
  [in]  HKEY                         hkeyClusterKey,
  [in]  const PRESUTIL_PROPERTY_ITEM pPropertyTable,
  [out] PVOID                        pOutPropertyList,
  [in]  DWORD                        cbOutPropertyListSize,
  [out] LPDWORD                      pcbBytesReturned,
  [out] LPDWORD                      pcbRequired
);

Parámetros

[in] hkeyClusterKey

Puntero a la clave de base de datos del clúster que identifica la ubicación de las propiedades que se van a recuperar.

[in] pPropertyTable

Puntero a una matriz de estructuras de RESUTIL_PROPERTY_ITEM que describen las propiedades que se van a recuperar.

[out] pOutPropertyList

Puntero a un búfer de salida en el que se va a devolver la lista de propiedades.

[in] cbOutPropertyListSize

Tamaño en bytes del búfer de salida al que apunta OutBuffer.

[out] pcbBytesReturned

Puntero al número total de bytes de la lista de propiedades a la que apunta OutBuffer.

[out] pcbRequired

Puntero al número de bytes necesarios si OutBuffer es demasiado pequeño.

Valor devuelto

Si las operaciones se realizan 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. A continuación se muestran los códigos de error posibles.

Código devuelto Descripción
ERROR_BAD_ARGUMENTS
 Uno o varios de los parámetros de entrada no eran válidos.
ERROR_NOT_ENOUGH_MEMORY
 Error al asignar memoria.
ERROR_MORE_DATA
 El tamaño del búfer de salida es demasiado pequeño para contener los datos resultantes. El parámetro pcbRequired apunta al tamaño correcto.

Comentarios

La función de utilidad ResUtilGetAllProperties realiza una entrada en la lista de propiedades para cada propiedad que sea:

Requisitos

   
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

RESUTIL_PROPERTY_ITEM