Funzione RtlStringCchLengthA (ntstrsafe.h)

Articolo
02/07/2025

Le funzioni RtlStringCchLengthW e RtlStringCchLength A determinano la lunghezza, in caratteri, di una stringa specificata.

Sintassi

NTSTRSAFEDDI RtlStringCchLengthA(
  [in] STRSAFE_PCNZCH psz,
  [in] size_t         cchMax,
       size_t         *pcchLength
);

Parametri

[in] psz

Puntatore a un buffer contenente una stringa con terminazione Null, la cui lunghezza verrà controllata.

[in] cchMax

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

pcchLength

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

Valore restituito

La funzione restituisce uno dei valori NTSTATUS elencati nella tabella seguente. Per informazioni su come testare i valori NTSTATUS, vedere Uso di valori NTSTATUS.

Codice restituito	Descrizione
STATUS_SUCCESS	Questo stato di esito positivo indica che la stringa in corrispondenza di psz non è stata NULLe la lunghezza della stringa (incluso il carattere Null di terminazione) è 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 o psz è più lungo di cchMax.

Osservazioni

RtlStringCchLengthW e RtlStringCchLengthA anziché strlen. Vengono usati per assicurarsi che una stringa non sia maggiore di una determinata lunghezza, in caratteri. Se tale condizione viene soddisfatta, RtlStringCchLengthW e RtlStringCchLengthA restituire la lunghezza corrente della stringa in caratteri, senza includere il carattere Null di terminazione.

Usare RtlStringCchLengthW per gestire stringhe Unicode e RtlStringCchLengthA per gestire le stringhe ANSI. Il modulo usato dipende dai dati, come illustrato nella tabella seguente.

Tipo di dati String	Valore letterale stringa	Funzione
WCHAR	L"string"	RtlStringCchLengthW
char	"string"	RtlStringCchLengthA

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

RtlStringCbLength

Condividi tramite