IAgentCharacter::SetName
[O Microsoft Agent foi preterido a partir do Windows 7 e pode estar indisponível nas versões subsequentes do Windows.]
HRESULT SetName(
BSTR bszName // character name
);
Define o nome do caractere.
- Retorna S_OK para indicar que a operação foi bem-sucedida.
-
bszName
-
Um BSTR que define o nome do caractere. O nome padrão de um caractere é definido quando ele é compilado com o Editor de Caracteres do Microsoft Agent. Você pode alterá-lo usando IAgentCharacter::SetName; no entanto, isso altera o nome do caractere para todos os clientes atuais do caractere. Essa propriedade não é persistente (armazenada permanentemente). O nome do caractere é revertido para seu nome padrão sempre que o caractere é carregado pela primeira vez por um cliente.
O nome do caractere também pode depender de sua ID de idioma. Os caracteres podem ser compilados com nomes diferentes para idiomas diferentes.
O servidor usa a configuração de nome do caractere em partes da interface do Microsoft Agent, como o título da Janela Comandos de Voz quando o caractere está ativo na entrada e no menu pop-up da barra de tarefas do Microsoft Agent.
Consulte Também