Compartir a través de

Función ResUtilSetPrivatePropertyList (resapi.h)

  • Artículo

Establece las propiedades privadas de un objeto de clúster.

Sintaxis

DWORD ResUtilSetPrivatePropertyList(
  [in] HKEY        hkeyClusterKey,
  [in] const PVOID pInPropertyList,
  [in] DWORD       cbInPropertyListSize
);

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] pInPropertyList

Puntero a un búfer de entrada que contiene una lista de propiedades con los nombres y valores de las propiedades que se van a establecer.

[in] cbInPropertyListSize

Puntero al tamaño en bytes del búfer de entrada al que apunta pInPropertyList.

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 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_INVALID_DATA
 Hubo un problema con la longitud de los datos de una propiedad.
ERROR_INSUFFICIENT_BUFFER
 El búfer de entrada al que apunta pInPropertyList era NULL.
ERROR_INVALID_PARAMETER
 La sintaxis de un nombre de propiedad no era válida.

Comentarios

Las propiedades establecidas en la función de utilidad ResUtilSetPrivatePropertyList se colocan en la parte de la base de datos de clúster debajo de la clave especificada para el objeto exactamente como se especifica en los nombres de la lista de propiedades. Si el nombre de una propiedad contiene caracteres de barra diagonal inversa (\), cada cadena que precede a un carácter de barra diagonal inversa se interpreta como un nombre de subclave y la última cadena que sigue al último carácter de barra diagonal inversa se interpreta como el nombre del valor.

No llame a ResUtilSetPrivatePropertyList desde las siguientes funciones de punto de entrada dll de recursos:

ResUtilSetPrivatePropertyList se puede llamar de forma segura desde cualquier otra función de punto de entrada dll de recursos 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

ResUtilVerifyPrivatePropertyList