Funzione RtlOemStringToCountedUnicodeString (ntifs.h)

Articolo
02/26/2024

La routine RtlOemStringToCountedUnicodeString converte la stringa di origine specificata in una stringa Unicode usando la tabella codici OEM di sistema corrente.

Sintassi

NTSYSAPI NTSTATUS RtlOemStringToCountedUnicodeString(
       PUNICODE_STRING DestinationString,
  [in] PCOEM_STRING    SourceString,
  [in] BOOLEAN         AllocateDestinationString
);

Parametri

DestinationString

Puntatore a un buffer allocato dal chiamante per ricevere la stringa Unicode tradotta. Se AllocateDestinationString è FALSE, il chiamante deve allocare anche un buffer per il membro Buffer di DestinationString per contenere i dati Unicode. Se AllocateDestinationString è TRUE, RtlOemStringToCountedUnicodeString alloca un buffer di dimensioni sufficienti per contenere la stringa, passa un puntatore a esso in Buffer e aggiorna di conseguenza i membri di lunghezza e lunghezza massima di DestinationString .

[in] SourceString

Puntatore alla stringa OEM da convertire in Unicode.

[in] AllocateDestinationString

Impostare su TRUE se RtlOemStringToCountedUnicodeString deve allocare lo spazio buffer per DestinationString, FALSE in caso contrario. Se questo parametro è TRUE, il chiamante è responsabile della liberazione del buffer quando non è più necessario chiamando RtlFreeUnicodeString.

Valore restituito

Se l'operazione ha esito positivo, RtlOemStringToCountedUnicodeString restituisce STATUS_SUCCESS. In caso contrario, non è stata allocata alcuna risorsa di archiviazione e non è stata eseguita alcuna conversione.

Commenti

RtlOemStringToCountedUnicodeString restituisce una stringa tradotta che non include il carattere di terminazione NULL. Converte la stringa di origine specificata usando la tabella codici OEM installata come tabella codici di sistema corrente in fase di avvio.

RtlOemStringToCountedUnicodeString non modifica la stringa di origine.

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