Funzione RtlUnicodeStringToOemString (winternl.h)

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