ResUtilEnumProperties-Funktion (resapi.h)

Listet die Eigenschaftennamen eines Clusterobjekts auf. Der PRESUTIL_ENUM_PROPERTIES Typ definiert einen Zeiger auf diese Funktion.

Syntax

DWORD ResUtilEnumProperties(
  [in]  const PRESUTIL_PROPERTY_ITEM pPropertyTable,
  [out] LPWSTR                       pszOutProperties,
  [in]  DWORD                        cbOutPropertiesSize,
  [out] LPDWORD                      pcbBytesReturned,
  [out] LPDWORD                      pcbRequired
);

Parameter

[in] pPropertyTable

Zeiger auf ein Array von RESUTIL_PROPERTY_ITEM Strukturen, die die aufzuzählenden Eigenschaften beschreiben.

[out] pszOutProperties

Zeiger auf den Ausgabepuffer, in dem die Namen aller Eigenschaften im Format mit mehreren Zeichenfolgen zurückgegeben werden sollen. Jeder Eigenschaftsname wird als Unicode-Zeichenfolge mit NULL-Beendigung gespeichert. Auf den Namen der letzten Eigenschaft folgt ein abschließendes NULL-Endzeichen.

[in] cbOutPropertiesSize

Größe in Bytes des Ausgabepuffers, auf den von pszOutProperties verwiesen wird.

[out] pcbBytesReturned

Zeiger auf die Gesamtanzahl von Bytes in der Eigenschaftsliste, auf die von pszOutProperties verwiesen wird.

[out] pcbRequired

Anzahl der erforderlichen Bytes, wenn der Ausgabepuffer zu klein ist.

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 sind mögliche Fehlercodes aufgeführt.

Rückgabecode	Beschreibung
ERROR_BAD_ARGUMENTS	Mindestens ein Eingabeparameter war ungültig.
ERROR_NOT_ENOUGH_MEMORY	Bei der Zuweisung von Arbeitsspeicher ist ein Fehler aufgetreten.
ERROR_MORE_DATA	Die Größe des Ausgabepuffers ist zu klein, um die resultierenden Daten aufzunehmen. Der pcbRequired-Parameter zeigt auf die richtige Größe.

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

Weitere Informationen

RESUTIL_PROPERTY_ITEM