IAgent::Load

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

HRESULT Load(
   VARIANT vLoadKey,  // data provider
   long * pdwCharID,  // address of a variable for character ID
   long * pdwReqID    // address of a variable for request ID
);

문자를 Characters 컬렉션에 로드합니다.

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

vLoadKey

다음 중 하나여야 하는 변형 데이터 형식입니다.

Description
filespec 지정된 문자 정의 파일의 로컬 파일 위치입니다.
URL 문자 정의 파일의 HTTP 주소입니다.

 

pdwCharID

문자의 ID를 받는 변수의 주소입니다.

pdwReqID

로드 요청 ID를 수신하는 변수의 주소입니다.

상대 경로(콜론 또는 선행 슬래시 문자가 포함되지 않은 경로)를 지정하여 Microsoft 에이전트 하위 디렉터리에서 문자를 로드할 수 있습니다. 그러면 경로 앞에 에이전트의 문자 디렉터리(지역화된 %windows%\msagent 디렉터리에 있음)가 접두사로 표시됩니다. 상대 주소를 사용하여 에이전트의 Chars 디렉터리에서 고유한 디렉터리를 지정할 수도 있습니다.

단일 연결에서 동일한 문자(GUID가 동일한 문자)를 두 번 이상 로드할 수 없습니다. 마찬가지로 기본 문자는 다른 문자와 같을 수 있으므로 단일 연결에서 기본 문자와 다른 문자를 동시에 로드할 수 없습니다. 그러나 CoCreateInstance를 사용하여 다른 연결을 만들고 동일한 문자를 로드할 수 있습니다.

Microsoft 에이전트의 데이터 공급자는 단일 구조화된 파일()로 저장된 문자 데이터 로드를 지원합니다. 문자 데이터와 애니메이션 데이터를 함께 사용하거나 별도의 문자 데이터(.)로 사용하는 ACS. ACF) 및 애니메이션(. ACA) 파일. 일반적으로 단일 구조화된 .를 사용합니다. ACS 파일은 로컬 디스크 드라이브 또는 네트워크에 저장되고 기존 파일 프로토콜(예: UNC 경로 이름)을 사용하여 액세스되는 문자를 로드합니다. 별도의 을 사용합니다. ACF 및 . HTTP 프로토콜을 사용하여 액세스되는 원격 사이트에서 애니메이션 파일을 개별적으로 로드하려는 경우 ACA 파일입니다.

의 경우 LOAD 메서드를 사용하는 ACS 파일은 문자의 애니메이션에 대한 액세스를 제공합니다. 로드되면 Play 메서드를 사용하여 캐릭터에 애니메이션 효과를 적용할 수 있습니다. 의 경우 ACF 파일도 Prepare 메서드를 사용하여 애니메이션 데이터를 로드합니다. Load 메서드는 다운로드를 지원하지 않습니다. HTTP 사이트의 ACS 파일입니다.

문자를 로드해도 문자가 자동으로 표시되지는 않습니다. 먼저 Show 메서드를 사용하여 문자를 표시합니다.