ResUtilGetDwordProperty-Funktion (resapi.h)
Ruft eine DWORD-Eigenschaft aus einer Eigenschaftsliste ab und führt einen Zeiger auf die nächste Eigenschaft in der Liste aus. Der PRESUTIL_GET_DWORD_PROPERTY Typ definiert einen Zeiger auf diese Funktion.
Syntax
DWORD ResUtilGetDwordProperty(
[out] LPDWORD pdwOutValue,
[in] const PCLUSPROP_DWORD pValueStruct,
[in] DWORD dwOldValue,
[in] DWORD dwMinimum,
[in] DWORD dwMaximum,
[out] LPBYTE *ppPropertyList,
[out] LPDWORD pcbPropertyListSize
);
Parameter
[out] pdwOutValue
Adresse eines Zeigers, in dem der DWORD-Wert aus der Eigenschaftenliste zurückgegeben wird.
[in] pValueStruct
Zeiger auf eine CLUSPROP_DWORD-Struktur , die den DWORD-Wert angibt, der aus der Eigenschaftenliste abgerufen werden soll.
[in] dwOldValue
Gibt den vorherigen Wert der Eigenschaft an.
[in] dwMinimum
Gibt den für die -Eigenschaft zulässigen Mindestwert an.
[in] dwMaximum
Gibt den maximal zulässigen Wert für die Eigenschaft an.
[out] ppPropertyList
Adresse des Zeigers auf den Eigenschaftenlistenpuffer, der die DWORD-Eigenschaft enthält. Dieser Zeiger wird bis zum Anfang der nächsten Eigenschaft erweitert.
[out] pcbPropertyListSize
Zeiger auf die Größe des Eigenschaftenlistenpuffers. Die Größe wird verringert, um den Fortschritt des ppPropertyList-Zeigers zu berücksichtigen.
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 ist ein möglicher Fehlercode aufgeführt.
| Rückgabecode | Beschreibung |
|---|---|
|
Die Daten sind falsch formatiert. |
Hinweise
Die ResUtilGetDwordProperty-Hilfsprogrammfunktion überprüft, ob der in pdwOutValue zurückgegebene Wert innerhalb des von dwMinimum und dwMaximum angegebenen Bereichs liegt. Wenn dwMinimum und dwMaximum beide auf 0 festgelegt sind, wird keine Bereichsprüfung durchgeführt.
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 |