ResUtilAddUnknownProperties-Funktion (resapi.h)
Ruft einen Satz unbekannter Eigenschaften aus der Clusterdatenbank ab und fügt sie an das Ende einer Eigenschaftenliste an.
Syntax
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
);
Parameter
[in] hkeyClusterKey
Zeiger auf den Clusterdatenbankschlüssel, der den Speicherort für die zu lesenden Eigenschaften identifiziert.
[in] pPropertyTable
Zeiger auf eine Eigenschaftentabelle , die die allgemeinen und privaten Eigenschaften eines Objekts beschreibt. Alle In der Clusterdatenbank gefundenen Eigenschaften, die sich nicht in dieser Eigenschaftentabelle befinden, werden der Eigenschaftenliste hinzugefügt.
[in, out] pOutPropertyList
Zeiger auf einen Puffer, in dem die zurückgegebenen Eigenschaften empfangen werden sollen. Bei der Eingabe kann der Puffer eine vorhandene Eigenschaftsliste enthalten oder leer sein. Bei der Ausgabe werden die abgerufenen Eigenschaften am Ende der vorhandenen Liste angefügt oder, wenn der Puffer leer ist, als neue Eigenschaftsliste zurückgegeben.
[in] pcbOutPropertyListSize
Gesamtbytegröße des Puffers, auf den pOutPropertyList verweist. Die Größe des Puffers muss groß genug sein, um die vorhandene Eigenschaftsliste und die zurückzugebende Eigenschaftsliste zu enthalten.
[in, out] pcbBytesReturned
Zeigen Sie bei der Eingabe auf die Bytegröße der Eigenschaftsliste, die im pOutPropertyList-Puffer enthalten ist. Zeigen Sie in der Ausgabe auf die Gesamtanzahl von Bytes in der Eigenschaftsliste, auf die von pOutPropertyList verwiesen wird.
[in, out] pcbRequired
Zeigt bei der Ausgabe auf die Gesamtanzahl der Bytes, die erforderlich sind, um die zurückgegebene Eigenschaftsliste zu enthalten. Wenn der pOutPropertyList-Puffer zu klein war, kann er auf die erforderliche Größe neu zugeordnet werden.
Rückgabewert
Wenn der Vorgang erfolgreich ist, gibt die Funktion ERROR_SUCCESS zurück.
Wenn der Vorgang fehlschlägt, gibt die Funktion einen Systemfehlercode zurück. Im Folgenden ist ein möglicher Fehlercode aufgeführt.
| Rückgabecode | Beschreibung |
|---|---|
|
Bei der Zuweisung von Arbeitsspeicher ist ein Fehler aufgetreten. |
Hinweise
Die Beziehungen zwischen den Eingabe- und Ausgabeparametern von ResUtilAddUnknownProperties werden im folgenden Diagramm veranschaulicht:
Die ResUtilAddUnknownProperties-Hilfsprogrammfunktion listet die in der Clusterdatenbank gespeicherten Eigenschaften (unter hkeyClusterKey) auf und sucht nach entsprechenden Eigenschaften in der Eigenschaftentabelle (pPropertyTable). Jede Eigenschaft, die in der Clusterdatenbank aufgeführt ist, aber nicht in der Eigenschaftentabelle aufgeführt ist, wird der Eigenschaftenliste (pOutPropertyList) hinzugefügt.
Anforderungen
| Anforderung | Wert |
|---|---|
| Unterstützte Mindestversion (Client) | Nicht unterstützt |
| Unterstützte Mindestversion (Server) | Windows Server 2008 Enterprise, Windows Server 2008 Datacenter |
| Zielplattform | Windows |
| Kopfzeile | resapi.h |
| Bibliothek | ResUtils.lib |
| DLL | ResUtils.dll |