Funzione GetCPInfoExW (winnls.h)
Recupera informazioni su qualsiasi tabella codici installata o disponibile valida.
Sintassi
BOOL GetCPInfoExW(
[in] UINT CodePage,
[in] DWORD dwFlags,
[out] LPCPINFOEXW lpCPInfoEx
);
Parametri
[in] CodePage
Identificatore della tabella codici per cui recuperare informazioni. L'applicazione può specificare l'identificatore della tabella codici per qualsiasi tabella codici installata o disponibile o uno dei valori predefiniti seguenti. Per un elenco di identificatori per ANSI e altre tabelle codici, vedere Identificatori della tabella codici.
[in] dwFlags
Riservati; deve essere 0.
[out] lpCPInfoEx
Puntatore a una struttura CPINFOEX che riceve informazioni sulla tabella codici.
Valore restituito
Restituisce un valore diverso da zero se ha esito positivo o 0 in caso contrario. Per ottenere informazioni estese sull'errore, l'applicazione può chiamare GetLastError, che può restituire uno dei codici di errore seguenti:
- ERROR_INVALID_PARAMETER. Uno dei valori dei parametri non è valido.
Commenti
Le informazioni recuperate nella struttura CPINFOEX non sono sempre utili per tutte le tabelle codici. Per determinare le dimensioni del buffer, ad esempio, l'applicazione deve chiamare MultiByteToWideChar o WideCharToMultiByte per richiedere una dimensione accurata del buffer. Se le impostazioni CPINFOEX indicano che esiste un byte lead, la funzione di conversione non gestisce necessariamente byte di lead in modo diverso, ad esempio nel caso di un byte mancante o non valido.
Nota
L'intestazione winnls.h definisce GetCPInfoEx 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 che non è indipendente dalla codifica può causare mancate corrispondenze che generano errori di compilazione o di runtime. Per altre informazioni, vedere Convenzioni per i prototipi di funzioni.
Requisiti
Requisito | Valore |
---|---|
Client minimo supportato | Windows 2000 Professional [app desktop | App UWP] |
Server minimo supportato | Windows 2000 Server [app desktop | App UWP] |
Piattaforma di destinazione | Windows |
Intestazione | winnls.h (include Windows.h) |
Libreria | Kernel32.lib |
DLL | Kernel32.dll |