Función ResUtilAddUnknownProperties (resapi.h)
Recupera un conjunto de propiedades desconocidas de la base de datos del clúster y los anexa al final de una lista de propiedades.
Sintaxis
DWORD ResUtilAddUnknownProperties(
[in] HKEY hkeyClusterKey,
[in] const PRESUTIL_PROPERTY_ITEM pPropertyTable,
[in, out] PVOID pOutPropertyList,
[in] DWORD pcbOutPropertyListSize,
[in, out] LPDWORD pcbBytesReturned,
[in, 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 leer.
[in] pPropertyTable
Puntero a una tabla de propiedades que describe las propiedades comunes y privadas de un objeto. Las propiedades que se encuentran en la base de datos del clúster que no están en esta tabla de propiedades se agregan a la lista de propiedades.
[in, out] pOutPropertyList
Puntero a un búfer en el que se van a recibir las propiedades devueltas. En la entrada, el búfer puede contener una lista de propiedades existente o puede estar vacía. En la salida, las propiedades recuperadas se anexarán al final de la lista existente o, si el búfer está vacío, se devolverá como una nueva lista de propiedades.
[in] pcbOutPropertyListSize
Tamaño total de bytes del búfer al que apunta pOutPropertyList. El tamaño del búfer debe ser lo suficientemente grande como para contener la lista de propiedades existente y la lista de propiedades que se va a devolver.
[in, out] pcbBytesReturned
En la entrada, puntero al tamaño de bytes de la lista de propiedades contenida en el búfer pOutPropertyList. En la salida, puntero al número total de bytes de la lista de propiedades a la que apunta pOutPropertyList.
[in, out] pcbRequired
En la salida, apunta al número total de bytes necesarios para contener la lista de propiedades devuelta. Si el búfer pOutPropertyList era demasiado pequeño, se puede reasignar al tamaño necesario.
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 muestra un posible código de error.
| Código devuelto | Descripción |
|---|---|
|
Error al asignar memoria. |
Comentarios
Las relaciones entre los parámetros de entrada y salida de ResUtilAddUnknownProperties se muestran en el diagrama siguiente:
La función de utilidad ResUtilAddUnknownProperties enumera las propiedades almacenadas en la base de datos del clúster (en hkeyClusterKey) y busca las propiedades correspondientes en la tabla de propiedades (pPropertyTable). Cada propiedad que aparece en la base de datos del clúster, pero que no aparece en la tabla de propiedades, se agrega a la lista de propiedades (pOutPropertyList).
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 |