ResUtilGetMultiSzValue-Funktion (resapi.h)

Gibt einen Wert mit mehreren Zeichenfolgen aus der Clusterdatenbank zurück.

Syntax

DWORD WINAPI_INLINE ResUtilGetMultiSzValue(
  [in]            HKEY    hkeyClusterKey,
  [in]            LPCWSTR pszValueName,
  [out, optional] LPWSTR  *ppszOutValue,
  [out]           LPDWORD pcbOutValueSize
);

Parameter

[in] hkeyClusterKey

Schlüssel, der den Speicherort des Werts mit mehreren Zeichenfolgen in der Clusterdatenbank angibt.

[in] pszValueName

Zeiger auf eine mit NULL beendete Unicode-Zeichenfolge, die den Namen des abzurufenden Werts enthält.

[out, optional] ppszOutValue

Adresse des Zeigers auf den abgerufenen Wert.

[out] pcbOutValueSize

Zeiger auf ein DWORD , in dem die Größe des Puffers in Bytes zurückgegeben wird, auf den ppszOutValue verweist.

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_NOT_ENOUGH_MEMORY	Während der Speicherzuordnung ist ein Fehler aufgetreten.

Hinweise

Wenn Sie mit dem Speicher fertig sind, der für den Wert zugewiesen ist, der von der ResUtilGetMultiSzValue-Hilfsprogrammfunktion zurückgegeben wird, müssen Sie die Funktion LocalFree aufrufen, um sie freizugeben.

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

Weitere Informationen

ClusterRegQueryValue

ResUtilGetBinaryValue

ResUtilGetDwordValue

ResUtilGetExpandSzValue

ResUtilGetSzValue