ResUtilSetMultiSzValue-Funktion (resapi.h)

Artikel
03/04/2024

Legt einen Wert mit mehreren Zeichenfolgen in der Clusterdatenbank fest. Der PRESUTIL_SET_MULTI_SZ_VALUE Typ definiert einen Zeiger auf diese Funktion.

Syntax

DWORD ResUtilSetMultiSzValue(
  [in]                HKEY    hkeyClusterKey,
  [in]                LPCWSTR pszValueName,
  [in]                LPCWSTR pszNewValue,
  [in]                DWORD   cbNewValueSize,
  [out, optional]     LPWSTR  *ppszOutValue,
  [in, out, optional] LPDWORD pcbOutValueSize
);

Parameter

[in] hkeyClusterKey

Schlüssel, der den Speicherort des mehrfachen Zeichenfolgenwerts in der Clusterdatenbank angibt.

[in] pszValueName

Mit Null beendete Unicode-Zeichenfolge, die den Namen des zu aktualisierenden Werts enthält.

[in] pszNewValue

Zeiger auf den neuen Mehrfachzeichenfolgenwert.

[in] cbNewValueSize

Größe des neuen Werts.

[out, optional] ppszOutValue

Zeiger auf einen Zeichenfolgenzeiger, der eine Kopie des aktualisierten Werts empfängt. Bei Verwendung müssen Aufrufer LocalFree für *ppszOutValue aufrufen.

[in, out, optional] pcbOutValueSize

Zeiger, der die Größe des neuen Werts empfängt.

Rückgabewert

Wenn der Vorgang erfolgreich ist, 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_NOT_ENOUGH_MEMORY	Fehler beim Zuweisen von Arbeitsspeicher.

Hinweise

Die ResUtilSetMultiSzValue-Hilfsprogrammfunktion weist Arbeitsspeicher für den neuen Wert zu und ruft die Cluster-API-Funktion ClusterRegSetValue auf.

Ein Wert mit mehreren Zeichenfolgen ist eine große Zeichenfolge, die kleinere, zusammenhängende Unicode-Zeichenfolgen mit Null-Termin enthält und nach der letzten Zeichenfolge mit einem zusätzlichen NULL-Zeichen endet.

Achten Sie darauf , LocalFree für *ppszOutValue aufzurufen, um Speicherverluste zu vermeiden.

Rufen Sie ResUtilSetMultiSzValue nicht über die folgenden Ressourcen-DLL-Einstiegspunktfunktionen auf:

ResUtilSetMultiSzValue kann von jeder anderen Ressourcen-DLL-Einstiegspunktfunktion oder aus einem Workerthread sicher aufgerufen werden. Weitere Informationen finden Sie unter Zu vermeidende Funktionsaufrufe in Ressourcen-DLLs.

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

ClusterRegSetValue

ResUtilSetBinaryValue

ResUtilSetDwordValue

ResUtilSetExpandSzValue

ResUtilSetSzValue

Freigeben über