ResUtilGetAllProperties-Funktion (resapi.h)

Artikel
08/25/2023

Gibt eine Eigenschaftenliste zurück, die alle Standardeigenschaften und unbekannte Eigenschaften für ein Clusterobjekt enthält. Der PRESUTIL_GET_ALL_PROPERTIES Typ definiert einen Zeiger auf diese Funktion.

Syntax

DWORD ResUtilGetAllProperties(
  [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 von OutBuffer verwiesen wird.

[out] pcbBytesReturned

Zeiger auf die Gesamtzahl der Bytes in der Eigenschaftsliste, auf die von OutBuffer verwiesen wird.

[out] pcbRequired

Zeiger auf die Anzahl von Bytes, die erforderlich ist, wenn OutBuffer 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_NOT_ENOUGH_MEMORY	Fehler beim Zuweisen von Arbeitsspeicher.
ERROR_MORE_DATA	Die Größe des Ausgabepuffers ist zu klein, um die resultierenden Daten aufzunehmen. Der parameter pcbRequired verweist auf die richtige Größe.

Hinweise

Die ResUtilGetAllProperties-Hilfsprogrammfunktion erstellt einen Eintrag in der Eigenschaftenliste für jede Eigenschaft, die wie folgt lautet:

In der Eigenschaftentabelle enthalten.
Wird in der Clusterdatenbank unterhalb des Schlüssels eingeschlossen, der durch den ClusterKey-Parameter identifiziert wird, unabhängig davon, ob die Eigenschaft in der Eigenschaftentabelle enthalten ist.

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

RESUTIL_PROPERTY_ITEM

Freigeben über