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
ERROR_BAD_ARGUMENTS	Mindestens einer der Eingabeparameter war ungültig.
ERROR_MORE_DATA	Der Ausgabepuffer war zu klein, um die resultierenden Daten zu enthalten. Der parameter pcbRequired gibt die erforderliche Größe an.
ERROR_NOT_ENOUGH_MEMORY	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

Weitere Informationen

ResUtilGetPrivateProperties