Funzione CharToOemBuffA (winuser.h)

Articolo
03/13/2024

Converte un numero specificato di caratteri in una stringa nel set di caratteri definito dall'OEM.

Sintassi

BOOL CharToOemBuffA(
  [in]  LPCSTR lpszSrc,
  [out] LPSTR  lpszDst,
  [in]  DWORD  cchDstLength
);

Parametri

[in] lpszSrc

Tipo: LPCTSTR

Stringa con terminazione null da tradurre.

[out] lpszDst

Tipo: LPSTR

Buffer per la stringa tradotta. Se la funzione CharToOemBuff viene usata come funzione ANSI, la stringa può essere tradotta sul posto impostando il parametro lpszDst sullo stesso indirizzo del parametro lpszSrc . Non è possibile eseguire questa operazione se CharToOemBuff viene usato come funzione wide-character.

[in] cchDstLength

Tipo: DWORD

Numero di caratteri da tradurre nella stringa identificata dal parametro lpszSrc .

Valore restituito

Tipo: BOOL

Il valore restituito è sempre diverso da zero, tranne quando si passa lo stesso indirizzo a lpszSrc e lpszDst nella versione wide-character della funzione. In questo caso la funzione restituisce zero e GetLastError restituisce ERROR_INVALID_ADDRESS.

Commenti

A differenza della funzione CharToOem, la funzione CharToOemBuff non interrompe la conversione di caratteri quando rileva un carattere Null nel buffer a cui punta lpszSrc. La funzione CharToOemBuff converte tutti i caratteri cchDstLength .

Nota

L'intestazione winuser.h definisce CharToOemBuff come alias che seleziona automaticamente la versione ANSI o Unicode di questa funzione in base alla definizione della costante preprocessore UNICODE. La combinazione dell'utilizzo dell'alias di codifica neutrale con il codice che non è neutrale dalla codifica può causare errori di corrispondenza che causano errori di compilazione o runtime. Per altre informazioni, vedere Convenzioni per i prototipi di funzione.

Requisiti

Requisito	Valore
Client minimo supportato	Windows 2000 Professional [solo app desktop]
Server minimo supportato	Windows 2000 Server [solo app desktop]
Piattaforma di destinazione	Windows
Intestazione	winuser.h (include Windows.h)
Libreria	User32.lib
DLL	User32.dll
Set di API	ext-ms-win-ntuser-chartranslation-l1-1-0 (introdotto in Windows 8)