Freigeben über


ResUtilGetExpandSzValue-Funktion (resapi.h)

[Diese Funktion ist für die Verwendung in den im Abschnitt Anforderungen angegebenen Betriebssystemen verfügbar. Die Unterstützung für diese Methode wurde in Windows Server 2003 entfernt. Diese Funktion wird nicht aus ResUtils.dll exportiert, und Programme oder DLLs, die statisch mit ihr verknüpft sind, werden nicht geladen.]

Gibt einen erweiterbaren Zeichenfolgenwert aus der Clusterdatenbank zurück.

Syntax

LPWSTR ResUtilGetExpandSzValue(
  [in] HKEY    hkeyClusterKey,
  [in] LPCWSTR pszValueName,
  [in] BOOL    bExpand
);

Parameter

[in] hkeyClusterKey

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

[in] pszValueName

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

[in] bExpand

Bei TRUE erweitert die Funktion die Zeichenfolge vor der Rückgabe. Bei FALSE wird die Zeichenfolge in einer erweiterbaren Form zurückgegeben.

Rückgabewert

Wenn die Vorgänge erfolgreich sind, gibt die Funktion eine Unicode-Zeichenfolge mit NULL-Beendigung zurück, die eine Kopie des angegebenen Werts enthält.

Wenn der Vorgang fehlschlägt, gibt die Funktion NULL zurück. Weitere Informationen finden Sie unter GetLastError.

Hinweise

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

Anforderungen

   
Unterstützte Mindestversion (Client) Nicht unterstützt
Unterstützte Mindestversion (Server) Windows Server 2003 Enterprise, Windows Server 2003 Datacenter
Zielplattform Windows
Kopfzeile resapi.h
Bibliothek ResUtils.lib
DLL ResUtils.dll

Weitere Informationen

ClusterRegQueryValue

ResUtilGetBinaryValue

ResUtilGetDwordValue

ResUtilGetMultiSzValue

ResUtilGetSzValue