Condividi tramite

Funzione RtlUnicodeStringInit (ntstrsafe.h)

  • Articolo

La funzione RtlUnicodeStringInit inizializza una struttura UNICODE_STRING.

Sintassi

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

Parametri

[out] DestinationString

Puntatore a una struttura UNICODE_STRING da inizializzare. Il puntatore pszSrc viene copiato nella struttura UNICODE_STRING del parametro DestinationString. Il numero massimo di caratteri nella stringa a cui punta pszSrc è NTSTRSAFE_UNICODE_STRING_MAX_CCH.

[in, optional] pszSrc

Opzionale. Puntatore a una costante stringa con terminazione Null. Questo puntatore stringa verrà copiato nel membro buffer della struttura UNICODE_STRING a cui punta il parametro DestinationString . Questo puntatore di stringa può essere NULL.

Valore restituito

RtlUnicodeStringInit restituisce uno dei valori NTSTATUS seguenti.

Codice restituito Descrizione
STATUS_SUCCESS
 Questo esito positivo stato indica che i dati di origine erano presenti, la stringa è stata copiata senza troncamento e il buffer di destinazione risultante viene terminato con null.
STATUS_INVALID_PARAMETER
 Questo errore stato indica che la funzione ha ricevuto un parametro di input non valido. Per altre informazioni, vedere l'elenco seguente.
 

RtlUnicodeStringInit restituisce il valore STATUS_INVALID_PARAMETER quando si verifica uno dei seguenti:

  • La lunghezza della stringa a cui punta il parametro pszSrc è maggiore di NTSTRSAFE_UNICODE_STRING_MAX_CCH caratteri.
  • Il puntatore DestinationString è NULL, ma il puntatore pszSrc non è NULL.
Per informazioni su come testare i valori NTSTATUS, vedere Uso di valori NTSTATUS.

Osservazioni

La funzione RtlUnicodeStringInit esegue le operazioni seguenti:

  • Imposta il membro Length della struttura UNICODE_STRING a cui punta il parametro pszSrc lunghezza, in byte, della stringa a cui punta il parametro pszSrc.
  • Imposta il membro MaximumLength della struttura UNICODE_STRING sulla lunghezza, in byte, della stringa a cui punta il parametro pszSrc più 2 byte.
  • Imposta il membro buffer della struttura di UNICODE_STRING sull'indirizzo specificato dal parametro pszSrc.
Il puntatore DestinationString non deve essere NULL. Se è necessario specificare valori di puntatoreDestinationString, usare la funzione RtlUnicodeStringInitEx .

Per altre informazioni sulle funzioni di stringa sicura, vedere Using Safe String Functions.For more information about the safe string functions, see Using Safe String Functions.

Fabbisogno

Requisito Valore
client minimo supportato Disponibile a partire da Windows XP con Service Pack 1 (SP1).
piattaforma di destinazione Desktop
intestazione ntstrsafe.h (include Ntstrsafe.h)
libreria Ntstrsafe.lib
IRQL Qualsiasi se le stringhe modificate sono sempre residenti in memoria, altrimenti PASSIVE_LEVEL

Vedere anche

RtlUnicodeStringInitEx

UNICODE_STRING