ResUtilFindLongProperty-Funktion (resapi.h)

Artikel
03/01/2024

Sucht einen signierten langen Eigenschaftswert in einer Eigenschaftsliste. Der PRESUTIL_FIND_LONG_PROPERTY Typ definiert einen Zeiger auf diese Funktion.

Syntax

DWORD ResUtilFindLongProperty(
  [in]  const PVOID pPropertyList,
  [in]  DWORD       cbPropertyListSize,
  [in]  LPCWSTR     pszPropertyName,
  [out] LPLONG      plPropertyValue
);

Parameter

[in] pPropertyList

Zeiger auf die Eigenschaftsliste, in der der Wert gefunden werden soll.

[in] cbPropertyListSize

Größe der in pPropertyList enthaltenen Daten in Bytes.

[in] pszPropertyName

Zeiger auf eine Unicode-Zeichenfolge mit NULL-Beendigung, die den Namen des zu suchenden Werts enthält.

[out] plPropertyValue

Zeiger auf den tatsächlichen Wert der im Eigenschaftenlistenpuffer gespeicherten Daten.

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

Rückgabecode	Beschreibung
ERROR_INVALID_DATA	Die Daten haben ein falsches Format.
ERROR_FILE_NOT_FOUND	Die Eigenschaft konnte sich nicht in der Eigenschaftenliste befinden.

Hinweise

Wenn der Vorgang erfolgreich ist, zeigt plPropertyValue direkt in den Eigenschaftenlistenpuffer. Achten Sie darauf, die Formatierung der Eigenschaftenliste nicht zu stören, wenn Sie plPropertyValue verwenden.

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