Compartir a través de

Función ResUtilGetPropertiesToParameterBlock (resapi.h)

  • Artículo

Recupera las propiedades especificadas por una tabla de propiedades de la base de datos del clúster y las devuelve en un bloque de parámetros.

Sintaxis

DWORD ResUtilGetPropertiesToParameterBlock(
  [in]            HKEY                         hkeyClusterKey,
  [in]            const PRESUTIL_PROPERTY_ITEM pPropertyTable,
  [out]           LPBYTE                       pOutParams,
  [in]            BOOL                         bCheckForRequiredProperties,
  [out, optional] LPWSTR                       *pszNameOfPropInError
);

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 describe las propiedades que se van a procesar.

[out] pOutParams

Puntero al bloque de parámetros de salida que se va a rellenar.

[in] bCheckForRequiredProperties

Especifica si se debe generar un error si faltan propiedades necesarias.

[out, optional] pszNameOfPropInError

Dirección del puntero de cadena en el que se va a devolver el nombre del error generado por una propiedad necesaria que falta. La propiedad ppszNameOfPropInError es opcional.

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.

Comentarios

Con la función de utilidad ResUtilGetPropertiesToParameterBlock , la tabla de propiedades a la que apunta pPropertyTable puede incluir valores predeterminados.

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

Consulte también

RESUTIL_PROPERTY_ITEM