ResUtilGetProperties-Funktion (resapi.h)
Ruft Eigenschaften ab, die von einer Eigenschaftentabelle aus der Clusterdatenbank angegeben werden, und gibt sie in einer Eigenschaftenliste zurück. Der PRESUTIL_GET_PROPERTIES Typ definiert einen Zeiger auf diese Funktion.
Syntax
DWORD ResUtilGetProperties(
[in] HKEY hkeyClusterKey,
[in] const PRESUTIL_PROPERTY_ITEM pPropertyTable,
[out] PVOID pOutPropertyList,
[in] DWORD cbOutPropertyListSize,
[out] LPDWORD pcbBytesReturned,
[out] LPDWORD pcbRequired
);
Parameter
[in] hkeyClusterKey
Zeiger auf den Clusterdatenbankschlüssel, der den Speicherort der abzurufenden Eigenschaften identifiziert.
[in] pPropertyTable
Zeiger auf ein Array von RESUTIL_PROPERTY_ITEM Strukturen, die die abzurufenden Eigenschaften beschreiben.
[out] pOutPropertyList
Zeiger auf einen Ausgabepuffer, in dem die Eigenschaftenliste zurückgegeben werden soll.
[in] cbOutPropertyListSize
Größe des Ausgabepuffers in Byte, auf den pOutPropertyList verweist.
[out] pcbBytesReturned
Zeiger auf die Gesamtzahl der Bytes in der Eigenschaftenliste, auf die von pOutPropertyList verwiesen wird.
[out] pcbRequired
Zeiger auf die Anzahl von Bytes, die erforderlich ist, wenn pOutPropertyList zu klein ist.
Rückgabewert
Wenn die Vorgänge erfolgreich sind, gibt die Funktion ERROR_SUCCESS zurück.
Wenn der Vorgang fehlschlägt, gibt die Funktion einen Systemfehlercode zurück. Im Folgenden finden Sie mögliche Fehlercodes.
| Rückgabecode | Beschreibung |
|---|---|
|
Mindestens einer der Eingabeparameter war ungültig. |
|
Der Ausgabepuffer war zu klein, um die resultierenden Daten zu enthalten. Der parameter pcbRequired gibt die erforderliche Größe an. |
|
Fehler beim Zuweisen von Arbeitsspeicher. |
Anforderungen
| 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 |