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
-
다음 중 하나여야 하는 variant 데이터 형식입니다.
값 Description filespec 지정된 문자 정의 파일의 로컬 파일 위치입니다. URL 문자 정의 파일의 HTTP 주소입니다. -
pdwCharID
-
문자의 ID를 받는 변수의 주소입니다.
-
pdwReqID
-
로드 요청 ID를 수신하는 변수의 주소입니다.
상대 경로(콜론 또는 선행 슬래시 문자가 포함되지 않은 경로)를 지정하여 Microsoft 에이전트 하위 디렉터리에서 문자를 로드할 수 있습니다. 이 접두사는 에이전트의 문자 디렉터리(지역화된 %windows%\msagent 디렉터리에 있음)를 사용하여 경로를 접두사로 합니다. 상대 주소를 사용하여 에이전트의 Chars 디렉터리에서 고유한 디렉터리를 지정할 수도 있습니다.
단일 연결에서 동일한 문자(GUID가 동일한 문자)를 두 번 이상 로드할 수 없습니다. 마찬가지로 기본 문자는 다른 문자와 같을 수 있으므로 단일 연결에서 기본 문자와 다른 문자를 동시에 로드할 수 없습니다. 그러나 CoCreateInstance를 사용하여 다른 연결을 만들고 동일한 문자를 로드할 수 있습니다.
Microsoft 에이전트의 데이터 공급자는 단일 구조적 파일()로 저장된 문자 데이터 로드를 지원합니다. ACS) 문자 데이터 및 애니메이션 데이터를 함께 사용하거나 별도의 문자 데이터()로 사용합니다. ACF) 및 애니메이션(. ACA) 파일. 일반적으로 단일 구조화된 를 사용합니다. ACS 파일은 로컬 디스크 드라이브 또는 네트워크에 저장되고 기존 파일 프로토콜(예: UNC 경로 이름)을 사용하여 액세스되는 문자를 로드합니다. 별도의 를 사용합니다. ACF 및 입니다. ACA 파일은 HTTP 프로토콜을 사용하여 액세스되는 원격 사이트에서 개별적으로 애니메이션 파일을 로드하려는 경우입니다.
의 경우 LOAD 메서드를 사용하는 ACS 파일은 문자의 애니메이션에 대한 액세스를 제공합니다. 로드되면 Play 메서드를 사용하여 캐릭터에 애니메이션 효과를 적용할 수 있습니다. 의 경우 ACF 파일도 Prepare 메서드를 사용하여 애니메이션 데이터를 로드합니다. Load 메서드는 다운로드를 지원하지 않습니다. HTTP 사이트의 ACS 파일입니다.
문자를 로드해도 문자가 자동으로 표시되지는 않습니다. 먼저 Show 메서드를 사용하여 문자를 표시합니다.