Funzione GetCurrencyFormatA (winnls.h)

Articolo
11/20/2024

Formatta una stringa numerica come stringa di valuta per le impostazioni locali specificate dall'identificatore.

Nota Per motivi di interoperabilità, l'applicazione deve preferire la funzione GetCurrencyFormatEx a GetCurrencyFormat perché Microsoft sta eseguendo la migrazione verso l'uso dei nomi delle impostazioni locali anziché degli identificatori delle impostazioni locali per le nuove impostazioni locali. Qualsiasi applicazione eseguita solo in Windows Vista e versioni successive deve usare GetCurrencyFormatEx.

Sintassi

int GetCurrencyFormatA(
  [in]            LCID               Locale,
  [in]            DWORD              dwFlags,
  [in]            LPCSTR             lpValue,
  [in, optional]  const CURRENCYFMTA *lpFormat,
  [out, optional] LPSTR              lpCurrencyStr,
  [in]            int                cchCurrency
);

Parametri

[in] Locale

identificatore delle impostazioni locali che specifica le impostazioni locali per cui questa funzione formatta la stringa di valuta. È possibile utilizzare la macro MAKELCID per creare un identificatore delle impostazioni locali o usare uno dei valori predefiniti seguenti.

[in] dwFlags

Flag che controllano il formato di valuta. L'applicazione deve impostare questo parametro su 0 se lpFormat non è impostato su NULL. In questo caso, la funzione formatta la stringa usando l'override dell'utente nel formato di valuta predefinito per le impostazioni locali. Se lpFormat è impostato su null, l'applicazione può specificare LOCALE_NOUSEROVERRIDE per formattare la stringa usando il formato di valuta predefinito del sistema per le impostazioni locali specificate.

Attenzione L'uso di LOCALE_NOUSEROVERRIDE è fortemente sconsigliato perché disabilita le preferenze utente.

[in] lpValue

Per informazioni dettagliate, vedere il parametro lpValue di GetCurrencyFormatEx.

[in, optional] lpFormat

Puntatore a una struttura CURRENCYFMT che contiene informazioni sulla formattazione della valuta. Tutti i membri della struttura devono contenere valori appropriati. L'applicazione può impostare questo parametro su NULL se la funzione usa il formato di valuta delle impostazioni locali specificate. Se questo parametro non è impostato su NULL, la funzione usa le impostazioni locali specificate solo per le informazioni di formattazione non specificate nella struttura CURRENCYFMT, ad esempio il valore stringa per il segno negativo utilizzato dalle impostazioni locali.

[out, optional] lpCurrencyStr

Puntatore a un buffer in cui questa funzione recupera la stringa di valuta formattata.

[in] cchCurrency

Dimensioni, in caratteri, del buffer lpCurrencyStr. L'applicazione imposta questo parametro su 0 se la funzione restituisce le dimensioni del buffer necessario per contenere la stringa di valuta formattata. In questo caso, il parametro lpCurrencyStr non viene usato.

Valore restituito

Restituisce il numero di caratteri recuperati nel buffer indicato da lpCurrencyStr in caso di esito positivo. Se il parametro cchCurrency è impostato su 0, la funzione restituisce le dimensioni del buffer necessario per contenere la stringa di valuta formattata, incluso un carattere Null di terminazione.

La funzione restituisce 0 se non riesce. Per ottenere informazioni estese sull'errore, l'applicazione può chiamare GetLastError, che può restituire uno dei codici di errore seguenti:

ERROR_INSUFFICIENT_BUFFER. Le dimensioni del buffer fornite non sono sufficienti o non sono state impostate correttamente su NULL.
ERROR_INVALID_FLAGS. I valori specificati per i flag non sono validi.
ERROR_INVALID_PARAMETER. Uno dei valori dei parametri non è valido.

Osservazioni

Questa funzione può recuperare i dati dalle impostazioni locali personalizzate . Non è garantito che i dati siano uguali da computer a computer o tra esecuzioni di un'applicazione. Se l'applicazione deve rendere persistenti o trasmettere i dati, vedere Using Persistent Locale Data.

Quando la versione ANSI di questa funzione viene usata con un identificatore delle impostazioni locali solo Unicode, la chiamata può avere esito positivo perché il sistema operativo usa la tabella codici del sistema. Tuttavia, i caratteri non definiti nella tabella codici di sistema vengono visualizzati nella stringa come punto interrogativo (?).

Nota

L'intestazione winnls.h definisce GetCurrencyFormat come alias che seleziona automaticamente la versione ANSI o Unicode di questa funzione in base alla definizione della costante del preprocessore UNICODE. La combinazione dell'utilizzo dell'alias indipendente dalla codifica con il codice non indipendente dalla codifica può causare mancate corrispondenze che generano errori di compilazione o di runtime. Per altre informazioni, vedere convenzioni di per i prototipi di funzioni.

Fabbisogno

Requisito	Valore
client minimo supportato	Windows 2000 Professional [solo app desktop]
server minimo supportato	Windows 2000 Server [solo app desktop]
piattaforma di destinazione	Finestre
intestazione	winnls.h (include Windows.h)
libreria	Kernel32.lib
dll	Kernel32.dll

Vedere anche

CURRENCYFMT

GetCurrencyFormatEx

GetNumberFormat

supporto linguistico nazionale

funzioni di supporto del linguaggio nazionale

Condividi tramite