Fonction ResUtilAddUnknownProperties (resapi.h)
Récupère un ensemble de propriétés inconnues de la base de données de cluster et les ajoute à la fin d’une liste de propriétés.
Syntaxe
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
);
Paramètres
[in] hkeyClusterKey
Pointeur vers la clé de base de données de cluster qui identifie l’emplacement des propriétés à lire.
[in] pPropertyTable
Pointeur vers une table de propriétés décrivant les propriétés communes et privées d’un objet. Toutes les propriétés trouvées dans la base de données de cluster qui ne figurent pas dans cette table de propriétés sont ajoutées à la liste des propriétés.
[in, out] pOutPropertyList
Pointeur vers une mémoire tampon dans laquelle recevoir les propriétés retournées. Lors de l’entrée, la mémoire tampon peut contenir une liste de propriétés existante, ou elle peut être vide. Lors de la sortie, les propriétés récupérées sont ajoutées à la fin de la liste existante ou, si la mémoire tampon est vide, retournent en tant que nouvelle liste de propriétés.
[in] pcbOutPropertyListSize
Taille totale en octets de la mémoire tampon pointée par pOutPropertyList. La taille de la mémoire tampon doit être suffisamment grande pour contenir la liste de propriétés existante et la liste de propriétés à retourner.
[in, out] pcbBytesReturned
Lors de l’entrée, pointeur vers la taille en octets de la liste de propriétés contenue dans la mémoire tampon pOutPropertyList. En sortie, pointeur vers le nombre total d’octets dans la liste de propriétés pointée par pOutPropertyList.
[in, out] pcbRequired
Sur la sortie, pointe vers le nombre total d’octets requis pour contenir la liste de propriétés retournée. Si la mémoire tampon pOutPropertyList était trop petite, elle peut être réaffectée à la taille requise.
Valeur retournée
Si l’opération réussit, la fonction retourne ERROR_SUCCESS.
Si l’opération échoue, la fonction retourne un code d’erreur système. Voici un code d’erreur possible.
| Code de retour | Description |
|---|---|
|
Une erreur s’est produite lors de l’allocation de la mémoire. |
Remarques
Les relations entre les paramètres d’entrée et de sortie de ResUtilAddUnknownProperties sont illustrées dans le diagramme suivant :
La fonction utilitaire ResUtilAddUnknownProperties énumère les propriétés stockées dans la base de données de cluster (sous hkeyClusterKey) et recherche les propriétés correspondantes dans la table de propriétés (pPropertyTable). Chaque propriété répertoriée dans la base de données de cluster, mais non répertoriée dans la table de propriétés, est ajoutée à la liste des propriétés (pOutPropertyList).
Configuration requise
| Condition requise | Valeur |
|---|---|
| Client minimal pris en charge | Aucun pris en charge |
| Serveur minimal pris en charge | Windows Server 2008 Entreprise, Windows Server 2008 Datacenter |
| Plateforme cible | Windows |
| En-tête | resapi.h |
| Bibliothèque | ResUtils.lib |
| DLL | ResUtils.dll |