Funzione RtlUnicodeToOemN (ntifs.h)

Articolo
02/26/2024

La routine RtlUnicodeToOemN converte una stringa Unicode specificata in una stringa OEM usando la tabella codici OEM del sistema corrente.

Sintassi

NTSYSAPI NTSTATUS RtlUnicodeToOemN(
  [out]           PCHAR  OemString,
  [in]            ULONG  MaxBytesInOemString,
  [out, optional] PULONG BytesInOemString,
  [in]            PCWCH  UnicodeString,
  [in]            ULONG  BytesInUnicodeString
);

Parametri

[out] OemString

Puntatore a un buffer allocato dal chiamante per ricevere la stringa tradotta.

[in] MaxBytesInOemString

Numero massimo di byte da scrivere in OemString.

[out, optional] BytesInOemString

Puntatore a una variabile allocata dal chiamante che riceve il numero di byte nella stringa tradotta. Questo parametro può essere NULL.

[in] UnicodeString

Puntatore alla stringa di origine Unicode da tradurre.

[in] BytesInUnicodeString

Dimensioni, in byte, della stringa in UnicodeString.

Valore restituito

RtlUnicodeToOemN restituisce STATUS_SUCCESS se la stringa completa in UnicodeString è stata tradotta e restituita in OemString.

Commenti

Per il valore restituito STATUS_BUFFER_OVERFLOW, la stringa troncata in OemString è stata tradotta senza errori.

Per il valore restituito STATUS_SUCCESS, il valore in ByteInOemString, se presente, indica la lunghezza della stringa restituita anziché quella specificata di MaxBytesInOemString.

RtlUnicodeToOemN non modifica la stringa di origine. Restituisce una stringa OEM con terminazione null se il valore BytesInUnicodeString specificato includeva un terminatore NULL e se il valore maxBytesInOemString specificato non causava il troncamento.

Per informazioni sulle altre routine di gestione delle stringhe, vedere Routine RTL (Run-Time Library).