Share via

IAgentCharacter::SetName

  • 아티클

[Microsoft 에이전트는 Windows 7을 기준으로 더 이상 사용되지 않으며 이후 버전의 Windows에서는 사용할 수 없습니다.]

HRESULT SetName(
   BSTR bszName   // character name
);

문자의 이름을 설정합니다.

  • 작업이 성공했음을 나타내는 S_OK 반환합니다.

bszName

문자의 이름을 설정하는 BSTR입니다. 문자의 기본 이름은 Microsoft 에이전트 문자 편집기를 사용하여 컴파일될 때 정의됩니다. IAgentCharacter::SetName을 사용하여 변경할 수 있습니다. 그러나 이렇게 하면 문자의 모든 현재 클라이언트에 대한 문자 이름이 변경됩니다. 이 속성은 영구적이지 않습니다(영구적으로 저장됨). 클라이언트에서 문자를 처음 로드할 때마다 문자의 이름이 기본 이름으로 되돌아갑니다.

문자의 이름은 언어 ID에 따라 달라질 수도 있습니다. 문자는 다른 언어에 대해 서로 다른 이름으로 컴파일할 수 있습니다.

서버는 문자가 입력 활성 상태일 때 음성 명령 창 제목 및 Microsoft 에이전트 작업 표시줄 팝업 메뉴와 같이 Microsoft 에이전트 인터페이스의 일부에서 문자의 이름 설정을 사용합니다.

참고 항목

IAgentCharacter::GetName