Função RtlUnicodeStringInit (ntstrsafe.h)

Artigo
07/16/2024

A função rtlUnicodeStringInit inicializa uma estrutura de UNICODE_STRING.

Sintaxe

NTSTRSAFEDDI RtlUnicodeStringInit(
  [out]          PUNICODE_STRING  DestinationString,
  [in, optional] NTSTRSAFE_PCWSTR pszSrc
);

Parâmetros

[out] DestinationString

Um ponteiro para uma estrutura UNICODE_STRING a ser inicializada. O ponteiro pszSrc é copiado para a estrutura de UNICODE_STRING do parâmetro DestinationString do . O número máximo de caracteres na cadeia de caracteres que pszSrc aponta é NTSTRSAFE_UNICODE_STRING_MAX_CCH.

[in, optional] pszSrc

Opcional. Um ponteiro para uma constante de cadeia de caracteres terminada em nulo. Esse ponteiro de cadeia de caracteres será copiado para o membro do buffer da estrutura de UNICODE_STRING apontada pelo parâmetro DestinationString . Esse ponteiro de cadeia de caracteres pode ser NULL.

Valor de retorno

RtlUnicodeStringInit retorna um dos seguintes valores NTSTATUS.

Código de retorno	Descrição
STATUS_SUCCESS	Esse êxito status significa que os dados de origem estavam presentes, a cadeia de caracteres foi copiada sem truncamento e o buffer de destino resultante foi encerrado em nulo.
STATUS_INVALID_PARAMETER	Esse erro status significa que a função recebeu um parâmetro de entrada inválido. Para obter mais informações, consulte a lista a seguir.

RtlUnicodeStringInit retorna o valor STATUS_INVALID_PARAMETER quando um dos seguintes ocorre:

O comprimento da cadeia de caracteres à qual o parâmetro pszSrc aponta é maior que NTSTRSAFE_UNICODE_STRING_MAX_CCH caracteres.
O ponteiro DestinationString é NULL, mas o ponteiro pszSrc não é NULL.

Para obter informações sobre como testar valores NTSTATUS, consulte Usando valores NTSTATUS.

Observações

A função rtlUnicodeStringInit faz o seguinte:

Define o membro Length da estrutura UNICODE_STRING apontado pelo parâmetro pszSrc para o comprimento, em bytes, da cadeia de caracteres à qual o parâmetro pszSrc aponta.
Define o membro MaximumLength da estrutura UNICODE_STRING ao comprimento, em bytes, da cadeia de caracteres que o parâmetro pszSrc aponta para mais 2 bytes.
Define o membro do buffer da estrutura UNICODE_STRING para o endereço especificado pelo parâmetro pszSrc .

O ponteiro DestinationString não deve ser NULL . Se você precisar especificar valores de ponteiroDestinationString, use a função RtlUnicodeStringInitEx.

Para obter mais informações sobre as funções de cadeia de caracteres seguras, consulte Usando funções de cadeia de caracteres seguras.

Requisitos

Requisito	Valor
de cliente com suporte mínimo	Disponível a partir do Windows XP com Service Pack 1 (SP1).
da Plataforma de Destino	Área de trabalho
cabeçalho	ntstrsafe.h (inclua Ntstrsafe.h)
biblioteca	Ntstrsafe.lib
IRQL	Se as cadeias de caracteres que estão sendo manipuladas estiverem sempre residentes na memória, caso contrário, PASSIVE_LEVEL

Consulte também

rtlUnicodeStringInitEx

UNICODE_STRING

Compartilhar via