Compartir a través de

Función ResUtilSetPropertyTable (resapi.h)

  • Artículo

Establece las propiedades de la base de datos del clúster en función de una lista de propiedades de una tabla de propiedades.

Sintaxis

DWORD ResUtilSetPropertyTable(
  [in]            HKEY                         hkeyClusterKey,
  [in]            const PRESUTIL_PROPERTY_ITEM pPropertyTable,
                  PVOID                        Reserved,
  [in]            BOOL                         bAllowUnknownProperties,
  [in]            const PVOID                  pInPropertyList,
  [in]            DWORD                        cbInPropertyListSize,
  [out, optional] LPBYTE                       pOutParams
);

Parámetros

[in] hkeyClusterKey

Clave de base de datos de clúster que identifica la ubicación de las propiedades que se van a establecer.

[in] pPropertyTable

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

Reserved

Reservado.

[in] bAllowUnknownProperties

Indica si se deben aceptar propiedades desconocidas . Este parámetro se establece en TRUE si se deben aceptar y FALSE si no.

[in] pInPropertyList

Puntero al búfer de entrada que contiene una lista de propiedades.

[in] cbInPropertyListSize

Tamaño en bytes del búfer de entrada al que apunta cbInPropertyList.

[out, optional] pOutParams

Puntero a un bloque de parámetros para contener los datos devueltos. Si se especifica, los parámetros solo se escriben si difieren de los del búfer de entrada.

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 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_INSUFFICIENT_BUFFER
 El tamaño del búfer de entrada especificado en cbInPropertyListSize es demasiado pequeño.
ERROR_INVALID_DATA
 El búfer de entrada al que apunta pInPropertyList es NULL, un nombre de propiedad no es válido o un valor de propiedad es demasiado pequeño.
ERROR_INVALID_PARAMETER
 La sintaxis, el formato o el tipo de una propiedad de la tabla de propiedades a la que apunta pPropertyTable es incorrecta o una propiedad es de solo lectura y no se puede establecer.

Comentarios

Si ya existe un valor especificado en la tabla de propiedades en la base de datos del clúster, el valor no se escribe. Para obtener información sobre cómo forzar que se escriban todos los valores, vea ResUtilSetPropertyTableEx.

No llame a ResUtilSetPropertyTable desde las siguientes funciones de punto de entrada dll de recursos.

ResUtilSetPropertyTable se puede llamar de forma segura desde cualquier otra función de punto de entrada dll de recurso o desde un subproceso de trabajo. Para obtener más información, consulte Llamadas de función para evitar en archivos DLL de recursos.

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

ResUtilSetPropertyTableEx