ResUtilFindMultiSzProperty-Funktion (resapi.h)

Artikel
03/06/2024

Sucht eine Eigenschaft mit mehreren Zeichenfolgen in einer Eigenschaftenliste. Der PRESUTIL_FIND_MULTI_SZ_PROPERTY Typ definiert einen Zeiger auf diese Funktion.

Syntax

DWORD ResUtilFindMultiSzProperty(
  [in]  const PVOID pPropertyList,
  [in]  DWORD       cbPropertyListSize,
  [in]  LPCWSTR     pszPropertyName,
  [out] LPWSTR      *pszPropertyValue,
  [out] LPDWORD     pcbPropertyValueSize
);

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] 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 *pbPropertyValue) aufrufen, um den zugewiesenen Arbeitsspeicher freizugeben. Wenn kein Wert erforderlich ist, übergeben Sie NULL für diesen Parameter.

[out] pcbPropertyValueSize

Zeiger auf die Größe des zurückgegebenen Werts in Bytes. Wenn keine Größe 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 ResUtilFindMultiSzProperty erfolgreich ist, verweist *pbPropertyValue auf eine Kopie der in pPropertyList gespeicherten Daten. Achten Sie darauf , LocalFree für *pbPropertyValue 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