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
ERROR_INVALID_PARAMETER	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

Weitere Informationen

ResUtilGetBinaryProperty

ResUtilGetMultiSzProperty

ResUtilGetSzProperty