Funzione RtlUnalignedStringCchLengthW (ntstrsafe.h)

Articolo
02/07/2025

La funzione RtlUnalignedStringCchLengthW è una versione della funzione RtlStringCchLeng th che accetta un puntatore non idoneo a una stringa di caratteri Unicode.

Sintassi

NTSTRSAFEDDI RtlUnalignedStringCchLengthW(
  [in]            STRSAFE_PCUNZWCH psz,
  [in]            size_t           cchMax,
  [out, optional] size_t           *pcchLength
);

Parametri

[in] psz

Fornisce un puntatore a un buffer contenente una stringa con terminazione Null la cui lunghezza RtlUnalignedStringCchLengthW verificherà.

[in] cchMax

Fornisce il numero massimo di caratteri consentiti nel buffer a cui psz punta, incluso il carattere NULL di terminazione. Questo valore non può superare NTSTRSAFE_MAX_CCH.

[out, optional] pcchLength

Opzionale. Se il chiamante fornisce un puntatoreNULL non, la funzione carica l'indirizzo con la lunghezza, in caratteri, della stringa contenuta nel buffer che psz punta. La lunghezza non include il carattere NULL di terminazione della stringa.

Valore restituito

RtlUnalignedStringCchLengthW restituisce uno dei valori NTSTATUS seguenti.

Codice restituito	Descrizione
STATUS_SUCCESS	Questo stato di esito positivo indica che la stringa che il parametro psz non è stato NULLe la lunghezza della stringa (incluso il carattere NULL di terminazione) era minore o uguale a caratteri cchMax.
STATUS_INVALID_PARAMETER	Questo stato di errore indica che il valore in psz è NULL, cchMax è maggiore di NTSTRSAFE_MAX_CCH oppure psz è più lungo di cchMax.

Per informazioni su come testare i valori NTSTATUS, vedere Uso di valori NTSTATUS.

Osservazioni

La funzione di RtlUnalignedStringCchLengthW è disponibile per le architetture del processore, ad esempio basate su Itanium e x64, che causano eccezioni di allineamento quando il software tenta di accedere ai dati non idonei. In questi processori è possibile usare RtlUnalignedStringCchLengthW anziché RtlStringCchLength per evitare eccezioni di allineamento. Per i processori che non causano eccezioni di allineamento, RtlUnalignedStringCchLengthW equivale a RtlStringCchLength.

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 in Windows XP con Service Pack 1 (SP1) e versioni successive di Windows.
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

RtlStringCchLength

Condividi tramite