ResUtilFindExpandSzProperty-Funktion (resapi.h)

Artikel
03/01/2024

Sucht eine erweiterbare Zeichenfolgeneigenschaft in einer Eigenschaftenliste. Der PRESUTIL_FIND_EXPAND_SZ_PROPERTY Typ definiert einen Zeiger auf diese Funktion.

Syntax

DWORD ResUtilFindExpandSzProperty(
  [in]            const PVOID pPropertyList,
  [in]            DWORD       cbPropertyListSize,
  [in]            LPCWSTR     pszPropertyName,
  [out, optional] LPWSTR      *pszPropertyValue
);

Parameter

[in] pPropertyList

Zeiger auf die Eigenschaftenliste, in der der Wert gesucht werden soll.

[in] cbPropertyListSize

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

[in] pszPropertyName

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

[out, optional] pszPropertyValue

Zeiger auf einen WCHAR-Zeiger auf einen Puffer (zugeordnet durch die Funktion), der eine Kopie des Eigenschaftswerts enthält. Sie müssen LocalFree (auf *pszPropertyValue) aufrufen, um den zugeordneten Arbeitsspeicher freizugeben. Wenn kein Wert erforderlich ist, übergeben Sie NULL für diesen Parameter.

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 finden Sie mögliche Fehlercodes.

Rückgabecode	Beschreibung
ERROR_INVALID_DATA	Die Eigenschaftenliste ist falsch formatiert.
ERROR_NOT_ENOUGH_MEMORY	Die Funktion konnte keinen Puffer zuordnen, in dem der Eigenschaftswert zurückgegeben werden soll.
ERROR_FILE_NOT_FOUND	Die angegebene Eigenschaft konnte nicht in der Eigenschaftenliste gefunden werden.

Hinweise

Wenn ResUtilFindExpandSzProperty erfolgreich ist, verweist *pszPropertyValue auf eine Kopie der in pPropertyList gespeicherten Daten. Achten Sie darauf , LocalFree für *pszPropertyValue aufzurufen, um Speicherverluste zu verhindern.

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