GetCurrencyFormatEx-Funktion (winnls.h)

Artikel
08/27/2023

Formatiert eine Zahlenzeichenfolge als Währungszeichenfolge für ein gebietsschema, das durch den Namen angegeben ist.

Hinweis Die Anwendung sollte diese Funktion vorzugsauf GetCurrencyFormat aufrufen, wenn sie nur unter Windows Vista und höher ausgeführt werden soll.

Hinweis Diese Funktion kann Daten formatieren, die sich zwischen Releases ändern, z. B. aufgrund eines benutzerdefinierten Gebietsschemas. Wenn Ihre Anwendung Daten beibehalten oder übertragen muss, finden Sie weitere Informationen unter Verwenden persistenter Gebietsschemadaten.

Syntax

int GetCurrencyFormatEx(
  [in, optional]  LPCWSTR            lpLocaleName,
  [in]            DWORD              dwFlags,
  [in]            LPCWSTR            lpValue,
  [in, optional]  const CURRENCYFMTW *lpFormat,
  [out, optional] LPWSTR             lpCurrencyStr,
  [in]            int                cchCurrency
);

Parameter

[in, optional] lpLocaleName

Zeiger auf einen Gebietsschemanamen oder einen der folgenden vordefinierten Werte.

[in] dwFlags

Flags, die den Vorgang der Funktion steuern. Die Anwendung muss diesen Parameter auf 0 festlegen, wenn lpFormat nicht auf NULL festgelegt ist. In diesem Fall formatiert die Funktion die Zeichenfolge mithilfe von Benutzerüberschreibungen in das Standardwährungsformat für das Gebietsschema. Wenn lpFormat auf NULL festgelegt ist, kann die Anwendung LOCALE_NOUSEROVERRIDE angeben, um die Zeichenfolge mithilfe des Systemstandardwährungsformats für das angegebene Gebietsschema zu formatieren.

Vorsicht Die Verwendung von LOCALE_NOUSEROVERRIDE wird dringend abgeraten, da die Benutzereinstellungen deaktiviert werden.

[in] lpValue

Zeiger auf eine NULL-beendete Zeichenfolge, die die zu formatende Zahlenzeichenfolge enthält. Diese Zeichenfolge darf nur die folgenden Zeichen enthalten. Alle anderen Zeichen sind ungültig. Die Funktion gibt einen Fehler zurück, wenn die Zeichenfolge von diesen Regeln abweicht.

Zeichen "0" bis "9"
Ein Dezimalpunkt (Punkt), wenn die Zahl ein Gleitkommawert ist
Ein Minuszeichen in der ersten Zeichenposition, wenn die Zahl ein negativer Wert ist

[in, optional] lpFormat

Zeiger auf eine CURRENCYFMT-Struktur , die Informationen zur Währungsformatierung enthält. Alle Member der Struktur müssen entsprechende Werte enthalten. Die Anwendung kann diesen Parameter auf NULL festlegen, wenn die Funktion das Währungsformat des angegebenen Gebietsschemas verwenden soll. Wenn dieser Parameter nicht auf NULL festgelegt ist, verwendet die Funktion das angegebene Gebietsschema nur für Formatierungsinformationen, die nicht in der CURRENCYFMT-Struktur angegeben sind, z. B. den Zeichenfolgenwert für das negative Zeichen, das vom Gebietsschema verwendet wird.

[out, optional] lpCurrencyStr

Zeiger auf einen Puffer, in dem diese Funktion die formatierte Währungszeichenfolge abruft.

[in] cchCurrency

Größe des Puffers lpCurrencyStr in Zeichen. Die Anwendung kann diesen Parameter auf 0 festlegen, um die Größe des Puffers zurückzugeben, der für die formatierte Währungszeichenfolge erforderlich ist. In diesem Fall wird der von lpCurrencyStr angegebene Puffer nicht verwendet.

Rückgabewert

Gibt die Anzahl der im Puffer abgerufenen Zeichen zurück, die von lpCurrencyStr angegeben werden, wenn dies erfolgreich war. Wenn der cchCurrency-Parameter 0 ist, gibt die Funktion die Größe des Puffers zurück, der für die formatierte Währungszeichenfolge erforderlich ist, einschließlich eines beendenden NULL-Zeichens.

Die Funktion gibt 0 zurück, wenn sie nicht erfolgreich ist. Um erweiterte Fehlerinformationen abzurufen, kann die Anwendung GetLastError aufrufen, wodurch einer der folgenden Fehlercodes zurückgegeben werden kann:

ERROR_INSUFFICIENT_BUFFER. Eine angegebene Puffergröße war nicht groß genug, oder sie wurde fälschlicherweise auf NULL festgelegt.
ERROR_INVALID_FLAGS. Die für Flags angegebenen Werte waren ungültig.
ERROR_INVALID_PARAMETER. Jeder der Parameterwerte war ungültig.

Hinweise

Ab Windows 8: Wenn Ihre App Sprachtags aus dem Windows.Globalization-Namespace an diese Funktion übergibt, müssen die Tags zuerst konvertiert werden , indem ResolveLocaleName aufgerufen wird.

Anforderungen


Unterstützte Mindestversion (Client)	Windows 2000 Professional [Desktop-Apps \| UWP-Apps]
Unterstützte Mindestversion (Server)	Windows 2000 Server [Desktop-Apps \| UWP-Apps]
Zielplattform	Windows
Kopfzeile	winnls.h (einschließlich Windows.h)
Bibliothek	Kernel32.lib
DLL	Kernel32.dll

Siehe auch

CURRENCYFMT

GetCurrencyFormat

GetNumberFormatEx

Unterstützung für nationale Sprachen

Nationale Sprachunterstützungsfunktionen

Freigeben über