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 |
|---|---|
|
Mindestens ein Eingabeparameter war ungültig. |
|
Bei der Zuweisung von Arbeitsspeicher ist ein Fehler aufgetreten. |
|
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 |