Funzione UtilAssembleStringsWithAlloc

Articolo
06/13/2023

La funzione UtilAssembleStringsWithAlloc alloca una stringa e la formatta usando le stringhe fornite dalla tabella stringa. Questa funzione usa StringCchPrintf per creare la stringa formattata.

Sintassi

HRESULT UtilAssembleStringsWithAlloc(
  _Out_ LPWSTR  *Buffer,
  _In_  UINT    BufferMax,
  _In_  LPCWSTR InputFormat,
  _In_  LPCWSTR InputString,
  _In_  BOOLEAN AdditionalArgument,
  _In_  ULONG   AdditionalValue
);

Parametri

Buffer [out]

Tipo: LPWSTR*

Posizione in cui verrà posizionata la stringa appena allocata. Quando la stringa non è più necessaria, deve essere rilasciata con CoTaskMemFree.

BufferMax [in]

Tipo: UINT

Numero massimo di caratteri consentiti nella stringa allocata da Buffer. Se la stringa formattata risultante è più lunga del numero di caratteri specificati, viene troncata e terminata null.

Nota

Questo parametro potrebbe non essere impostato su zero.

InputFormat [in]

Tipo: LPCWSTR

Risorsa stringa fuori dalla tabella stringa che rappresenta un parametro di formato passato a StringCchPrintf. Viene costruito usando MAKEINTRESOURCE.

Il formato stringa di risorsa deve specificare un parametro di formato che accetta una stringa wide o un parametro di formato che accetta una stringa senza segno e una stringa wide.

InputString [in]

Tipo: LPCWSTR

Risorsa stringa fuori dalla tabella stringa che rappresenta un argomento passato a StringCchPrintf al posto della stringa wide nel parametro di formato. Viene costruito usando MAKEINTRESOURCE.

AggiuntivoArgument [in]

Tipo: BOOLEAN

True se AdditionalValue deve essere passato come primo argomento di formattazione a StringCchPrintf; in caso contrario, false (e solo la stringa di risorsa identificata da InputString verrà passata).

AdditionalValue [in]

Tipo: ULONG

Valore da passare come primo argomento di formattazione a StringCchPrintf se AdditionalArgument è true.

Valore restituito

Tipo: HRESULT

I valori restituiti possibili includono, ma non sono limitati a, quanto segue.

Codice restituito	Descrizione
S_OK	Operazione completata.
E_INVALIDARG	Uno o più parametri non sono stati forniti correttamente.

Requisiti

Requisito	Valore
Client minimo supportato	Windows 8 [solo app desktop]
Server minimo supportato	Windows Server 2012 [solo app desktop]
Intestazione	Ndattributils.h

Vedi anche

UtilStringCopyWithAlloc
UtilLoadStringWithAlloc
StringCchPrintf
MAKEINTRESOURCE
CoTaskMemFree

Condividi tramite