Freigeben über


ResUtilGetMultiSzProperty-Funktion (resapi.h)

Ruft eine Eigenschaft mit mehreren Zeichenfolgen aus einer Eigenschaftsliste ab und führt einen Zeiger auf die nächste Eigenschaft in der Liste aus. Der PRESUTIL_GET_MULTI_SZ_PROPERTY-Typs definiert einen Zeiger auf diese Funktion.

Syntax

DWORD ResUtilGetMultiSzProperty(
  [out]          LPWSTR             *ppszOutValue,
  [out]          LPDWORD            pcbOutValueSize,
  [in]           const PCLUSPROP_SZ pValueStruct,
  [in, optional] LPCWSTR            pszOldValue,
  [in]           DWORD              cbOldValueSize,
  [in, out]      LPBYTE             *ppPropertyList,
  [in, out]      LPDWORD            pcbPropertyListSize
);

Parameter

[out] ppszOutValue

Adresse eines Zeigers, in dem der Wert für mehrere Zeichenfolgen aus der Eigenschaftenliste zurückgegeben wird.

[out] pcbOutValueSize

Zeiger auf die Größe des Ausgabewerts.

[in] pValueStruct

Zeiger auf eine CLUSPROP_MULTI_SZ-Struktur , die den wert für mehrere Zeichenfolgen angibt, der aus der Eigenschaftenliste abgerufen werden soll.

[in, optional] pszOldValue

Zeiger auf den vorherigen Wert der Eigenschaft.

[in] cbOldValueSize

Zeiger auf die Länge des vorherigen Werts der Eigenschaft.

[in, out] ppPropertyList

Adresse des Zeigers auf den Eigenschaftenlistenpuffer, der die Eigenschaft mit mehreren Zeichenfolgen enthält. Dieser Zeiger wird bis zum Anfang der nächsten Eigenschaft erweitert.

[in, 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.

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

ResUtilGetDwordProperty

ResUtilGetSzProperty