Metodo CHString::Format(UINT,...) (chstring.h)

[La classe CHString fa parte di WMI Provider Framework, che viene ora considerata in stato finale e non saranno disponibili ulteriori sviluppi, miglioramenti o aggiornamenti per problemi non correlati alla sicurezza che interessano queste librerie. Le API MI devono essere usate per tutti i nuovi sviluppi.

Il metodo Format formatta e archivia una serie di caratteri e valori in una stringa CHString .

Sintassi

void  throw(CHeap_Exception) Format(
  UINT nFormatID,
  ...  
);

Parametri

nFormatID

Identificatore di risorsa stringa che contiene la stringa di controllo del formato.

...

Elenco di argomenti.

Valore restituito

CHeap_Exception

Commenti

Ogni argomento facoltativo (se presente) viene convertito e restituito in base alla specifica di formato corrispondente in lpszFormat o dalla risorsa stringa identificata da nFormatID.

Nota Per ridurre l'esposizione agli attacchi di sicurezza, usare sempre una stringa di formato per Format. Ad esempio, Format(input) è sfruttabile e Format("%s", input) non è. Non usare mai una stringa fornita dall'utente per la stringa di formato. Se la stringa di formato viene archiviata a scopo di localizzazione, assicurarsi che la stringa sia protetta dall'accesso in scrittura non autorizzato. Se la funzione scrive in una stringa anziché in un output standard, potrebbe essere necessario evitare di usare una stringa finale "%s" nella stringa di formato.

Se l'oggetto stringa viene offerto come parametro a Format, la chiamata ha esito negativo. Ad esempio, il codice seguente causa risultati imprevedibili.

Esempio

CHString str = L"Some Data";

// Attention: str is also used in the parameter list.
str.Format(L"%s%d", str, 123);

Nota Quando si passa una stringa di caratteri come argomento facoltativo, è necessario eseguirne il cast in modo esplicito come LPCWSTR. L'argomento format ha la stessa forma e funzione dell'argomento format per la funzione printf . Alla fine dei caratteri scritti viene aggiunto un carattere NULL .

Requisiti

Vedi anche

CHString

CHString::GetBuffer