IAgentCharacter::SetName

[O Microsoft Agent foi preterido a partir do Windows 7 e pode não estar disponível em versões subsequentes do Windows.]

HRESULT SetName(
   BSTR bszName   // character name
);

Define o nome do personagem.

• Retorna S_OK para indicar que a operação foi bem-sucedida.

bszName

Um BSTR que define o nome do personagem. 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 personagem. Esta propriedade não é persistente (armazenada permanentemente). O nome do personagem reverte para seu nome padrão sempre que o caractere é carregado pela primeira vez por um cliente.

O nome do personagem também pode depender de seu ID de idioma. Os caracteres podem ser compilados com nomes diferentes para diferentes idiomas.

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 de entrada e no menu pop-up da barra de tarefas do Microsoft Agent.

Ver também

IAgentCharacter::GetName