ResUtilSetSzValue-Funktion (resapi.h)

Legt einen Zeichenfolgenwert in der Clusterdatenbank fest. Der PRESUTIL_SET_SZ_VALUE Typ definiert einen Zeiger auf diese Funktion.

Syntax

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

Parameter

[in] hkeyClusterKey

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

[in] pszValueName

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

[in] pszNewValue

Zeiger auf den neuen 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 ResUtilSetSzValue-Hilfsprogrammfunktion weist Arbeitsspeicher für den neuen Wert zu und ruft die Cluster-API-FunktionClusterRegSetValue auf. Bei Bedarf wird ein vorheriger Wert zugeordnet. Der neue Wert wird in den Inhalt von ppszOutValue kopiert.

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

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

ResUtilSetSzValue 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

   
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

ResUtilSetMultiSzValue

  • Last updated on