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 pszSrc punta è NTSTRSAFE_UNICODE_STRING_MAX_CCH.

[in, optional] pszSrc

facoltativo. Puntatore a una costante stringa con terminazione null. Questo puntatore di 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 stato di esito positivo indica che i dati di origine erano presenti, la stringa è stata copiata senza troncamento e il buffer di destinazione risultante viene terminato con valore Null.
STATUS_INVALID_PARAMETER
 Questo stato di errore indica che la funzione ha ricevuto un parametro di input non valido. Per altre informazioni, vedere l'elenco seguente.
 

RtlUnicodeStringInit restituisce il valore di STATUS_INVALID_PARAMETER quando si verifica una delle operazioni seguenti:

  • 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.

Commenti

La funzione RtlUnicodeStringInit esegue le operazioni seguenti:

  • Imposta il membro Length della struttura UNICODE_STRING a cui punta il parametro pszSrc sulla 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 che il parametro pszSrc punta a più 2 byte.
  • Imposta il membro buffer della struttura UNICODE_STRING sull'indirizzo specificato dal parametro pszSrc .
Il puntatore DestinationString non deve essere NULL. Se è necessario specificare i valori del puntatore NULL DestinationString, usare la funzione RtlUnicodeStringInitEx.

Per altre informazioni sulle funzioni di stringa sicura, vedere Uso di funzioni stringhe sicure.

Requisiti

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, in caso contrario PASSIVE_LEVEL

Vedi anche

RtlUnicodeStringInitEx

UNICODE_STRING