Compartilhar via


Função RtlUnicodeStringToOemString (winternl.h)

Converte a cadeia de caracteres de origem Unicode especificada em uma cadeia de caracteres OEM. A tradução é feita em relação à página de código OEM (OCP).

Sintaxe

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

Parâmetros

[out] DestinationString

Um ponteiro para uma estrutura OEM_STRING que contém o OEM equivalente à cadeia de caracteres de origem Unicode. O campo MaximumLength será definido se AllocateDestinationString for TRUE.

[in] SourceString

Um ponteiro para uma estrutura UNICODE_STRING que deve ser convertida em OEM.

[in] AllocateDestinationString

Controla a alocação do espaço de buffer para a cadeia de caracteres de destino.

TRUE

O espaço de buffer é alocado para DestinationString. Se definido como TRUE, o buffer deverá ser desalocado usando RtlFreeOemString.

FALSE

O espaço em buffer não é alocado para DestinationString.

Retornar valor

Os vários valores NTSTATUS são definidos em NTSTATUS. H, que é distribuído com o DDK do Windows.

Código de retorno Descrição
STATUS_SUCCESS
A cadeia de caracteres Unicode foi convertida em OEM. Caso contrário, nenhum armazenamento foi alocado e nenhuma conversão foi feita.

Comentários

Essa rotina aloca um buffer somente para DestinationString .

Requisitos

Requisito Valor
Cliente mínimo com suporte Windows 2000 Professional [somente aplicativos da área de trabalho]
Servidor mínimo com suporte Windows 2000 Server [somente aplicativos da área de trabalho]
Plataforma de Destino Windows
Cabeçalho winternl.h
Biblioteca ntdll.lib
DLL ntdll.dll