Método CHString::Format(UINT,...) (chstring.h)
[A classe CHString faz parte do WMI Provider Framework que agora é considerado em estado final e nenhum desenvolvimento, melhoria ou atualização adicional estará disponível para problemas não relacionados à segurança que afetarem essas bibliotecas. As APIs de MI devem ser usadas em todos os novos desenvolvimentos.]
O método Format formata e armazena uma série de caracteres e valores em uma cadeia de caracteres CHString.
Sintaxe
void throw(CHeap_Exception) Format(
UINT nFormatID,
...
);
Parâmetros
nFormatID
Identificador de recurso de cadeia de caracteres que contém a cadeia de caracteres de controle de formato.
...
Lista de argumentos.
Retornar valor
CHeap_Exception
Comentários
Cada argumento opcional (se houver) é convertido e gerado de acordo com a especificação de formato correspondente em lpszFormat ou do recurso de cadeia de caracteres identificado por nFormatID.
Nota Para reduzir a exposição a ataques de segurança, sempre use uma cadeia de caracteres de formato para Format. Por exemplo, Format(input) é explorável e Format("%s", input) não é. Nunca use uma cadeia de caracteres fornecida pelo usuário para a cadeia de caracteres de formato. Se a cadeia de caracteres de formato estiver armazenada para uma finalidade como localização, verifique se a cadeia de caracteres está protegida contra acesso de gravação não autorizado. Se a função gravar em uma cadeia de caracteres em vez de uma saída padrão, talvez seja necessário evitar o uso de um "%s" à direita na cadeia de caracteres de formato.
Se o objeto de cadeia de caracteres for oferecido como um parâmetro para Format, a chamada falhará. Por exemplo, o código a seguir causa resultados imprevisíveis.
Exemplos
CHString str = L"Some Data";
// Attention: str is also used in the parameter list.
str.Format(L"%s%d", str, 123);
Nota Ao passar uma cadeia de caracteres como um argumento opcional, você deve convertê-la explicitamente como LPCWSTR. O argumento format tem a mesma forma e função que o argumento format para a função printf . Um caractere NULL é acrescentado ao final dos caracteres gravados.
Requisitos
| Requisito | Valor |
|---|---|
| Cabeçalho | chstring.h |