ResUtilSetExpandSzValue-Funktion (resapi.h)

Artikel
03/01/2024

Legt einen erweiterbaren Zeichenfolgenwert in der Clusterdatenbank fest. Der PRESUTIL_SET_EXPAND_SZ_VALUE-Typs definiert einen Zeiger auf diese Funktion.

Syntax

DWORD ResUtilSetExpandSzValue(
  [in]                HKEY    hkeyClusterKey,
  [in]                LPCWSTR pszValueName,
  [in]                LPCWSTR pszNewValue,
  [in, out, optional] LPWSTR  *ppszOutString
);

Parameter

[in] hkeyClusterKey

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

[in] pszValueName

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

[in] pszNewValue

Zeiger auf den neuen erweiterbaren Zeichenfolgenwert.

[in, out, optional] ppszOutString

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

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	Beim Zuweisen von Arbeitsspeicher ist ein Fehler aufgetreten.

Hinweise

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

Ein erweiterbarer Zeichenfolgenwert enthält Daten, die eine Unicode-Zeichenfolge mit Null-Endung darstellen, die nicht erweiterte Verweise auf Umgebungsvariablen wie "%SystemRoot%" enthält.

Rufen Sie LocalFree auf *ppszOutValue auf, um Speicherverluste zu vermeiden.

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

ResUtilSetExpandSzValue 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

ResUtilSetMultiSzValue

ResUtilSetSzValue

Freigeben über