Funzione RtlUnicodeStringToOemString (winternl.h)

Articolo
03/04/2024

Converte la stringa di origine Unicode specificata in una stringa OEM. La traduzione viene eseguita rispetto alla tabella codici OEM (OCP).

Sintassi

NTSTATUS RtlUnicodeStringToOemString(
  [out] POEM_STRING      DestinationString,
  [in]  PCUNICODE_STRING SourceString,
  [in]  BOOLEAN          AllocateDestinationString
);

Parametri

[out] DestinationString

Puntatore a una struttura OEM_STRING contenente l'OEM equivalente alla stringa di origine Unicode. Il campo MaximumLength è impostato se AllocateDestinationString è TRUE.

[in] SourceString

Puntatore a una struttura UNICODE_STRING da convertire in OEM.

[in] AllocateDestinationString

Controlla l'allocazione dello spazio del buffer per la stringa di destinazione.

true

Lo spazio del buffer viene allocato per DestinationString. Se impostato su TRUE, il buffer deve essere deallocato usando RtlFreeOemString.

FALSE

Lo spazio del buffer non viene allocato per DestinationString.

Valore restituito

I vari valori NTSTATUS sono definiti in NTSTATUS. H, distribuito con Windows DDK.

Codice restituito	Descrizione
STATUS_SUCCESS	La stringa Unicode è stata convertita in OEM. In caso contrario, nessuna risorsa di archiviazione è stata allocata e non è stata eseguita alcuna conversione.

Commenti

Questa routine alloca un buffer solo per DestinationString .

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	winternl.h
Libreria	ntdll.lib
DLL	ntdll.dll

Condividi tramite