Funzione RtlAppendUnicodeToString (wdm.h)

Articolo
08/08/2023

La routine RtlAppendUnicodeToString concatena la stringa Unicode fornita a una stringa Unicode memorizzata nel buffer.

Sintassi

NTSYSAPI NTSTATUS RtlAppendUnicodeToString(
  [in, out]      PUNICODE_STRING Destination,
  [in, optional] PCWSTR          Source
);

Parametri

[in, out] Destination

Puntatore alla stringa memorizzata nel buffer.

[in, optional] Source

Puntatore alla stringa con terminazione null da aggiungere alla stringa di destinazione .

Valore restituito

RtlAppendUnicodeToString può restituire uno dei seguenti elementi:

Codice restituito	Descrizione
STATUS_SUCCESS	La stringa di origine è stata aggiunta correttamente alla stringa di destinazione e la lunghezza della stringa di destinazione è stata aggiornata per includere i byte accodati.
STATUS_BUFFER_TOO_SMALL	Il buffer della stringa di destinazione è troppo piccolo per consentire l'accodamento della stringa di origine, quindi la lunghezza della stringa di destinazione non viene aggiornata e il contenuto del buffer stringa di destinazione non viene modificato.

Commenti

RtlAppendUnicodeToString aggiunge la stringa di origine alla fine della stringa di destinazione.

Se il buffer di destinazione non è sufficiente per contenere la stringa che comporta la concatenazione delle stringhe di origine e di destinazione (non incluso il carattere Null che termina la stringa di origine), la routine restituisce STATUS_BUFFER_TOO_SMALL e lascia invariata la stringa di destinazione.

Il buffer di destinazione deve essere residente se il chiamante è in esecuzione in IRQL >= DISPATCH_LEVEL.

Requisiti

Requisito	Valore
Client minimo supportato	Disponibile a partire da Windows 2000.
Piattaforma di destinazione	Universale
Intestazione	wdm.h (include Wdm.h, Ntddk.h, Ntifs.h, Wudfwdm.h)
Libreria	NtosKrnl.lib
DLL	NtosKrnl.exe (modalità kernel); Ntdll.dll (modalità utente)
IRQL	Vedere La sezione Osservazioni.

Vedi anche

RtlAppendUnicodeStringToString

Condividi tramite