Funzione OemToCharBuffA (winuser.h)

Articolo
11/20/2024

Converte un numero specificato di caratteri in una stringa dal set di caratteri definito dall'OEM in una stringa ANSI o in una stringa di caratteri wide.

Sintassi

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

Parametri

[in] lpszSrc

Tipo: LPCSTR

Uno o più caratteri del set di caratteri definito dall'OEM.

[out] lpszDst

Tipo: LPTSTR

Buffer di destinazione, che riceve la stringa tradotta. Se la funzione OemToCharBuff viene usata come funzione ANSI, la stringa può essere convertita sul posto impostando il parametro lpszDst sullo stesso indirizzo del parametro lpszSrc. Questa operazione non può essere eseguita se la funzione OemToCharBuff viene usata come funzione a caratteri wide.

[in] cchDstLength

Tipo: DWORD

Numero di caratteri da convertire nel buffer identificato 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 a caratteri wide della funzione. In questo caso la funzione restituisce zero e GetLastError restituisce ERROR_INVALID_ADDRESS.

Osservazioni

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

Nota

L'intestazione winuser.h definisce OemToCharBuff 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	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)