IAgent::Load

[O Microsoft Agent foi preterido a partir do Windows 7 e pode estar indisponível nas versões subsequentes do 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
);

Carrega um caractere na coleção Characters .

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

vLoadKey

Um tipo de dados variante que deve ser um dos seguintes:

Valor	Descrição
filespec	O local do arquivo do arquivo de definição do caractere especificado.
URL	O endereço HTTP do arquivo de definição do caractere.

 

pdwCharID

Endereço de uma variável que recebe a ID do caractere.

pdwReqID

Endereço de uma variável que recebe a ID da solicitação de carga .

Você pode carregar caracteres do subdiretório do Microsoft Agent especificando um caminho relativo (aquele que não inclui dois-pontos ou caractere de barra à esquerda). Isso prefixa o caminho com o diretório de caracteres do Agente (localizado no diretório %windows%\msagent localizado). Você também pode usar um endereço relativo para especificar seu próprio diretório no diretório Chars do Agent.

Você não pode carregar o mesmo caractere (um caractere com o mesmo GUID) mais de uma vez de uma única conexão. Da mesma forma, você não pode carregar o caractere padrão e outros caracteres ao mesmo tempo de uma única conexão, pois o caractere padrão pode ser o mesmo que o outro caractere. No entanto, você pode criar outra conexão (usando CoCreateInstance) e carregar o mesmo caractere.

O provedor de dados do Microsoft Agent dá suporte ao carregamento de dados de caractere armazenados como um único arquivo estruturado (. ACS) com dados de caracteres e dados de animação juntos ou como dados de caracteres separados (. ACF) e animação (. Arquivos ACA). Geralmente, use o único estruturado . Arquivo ACS para carregar um caractere armazenado em uma unidade de disco ou rede local e acessado usando o protocolo de arquivo convencional (como nomes de caminho UNC). Use o separado. ACF e . Arquivos ACA quando você deseja carregar os arquivos de animação individualmente de um site remoto onde eles são acessados usando o protocolo HTTP.

Para. Arquivos ACS, usando o método Load fornece acesso às animações de um caractere; depois de carregado, você pode usar o método Play para animar o caractere. Para. Arquivos ACF, você também usa o método Prepare para carregar dados de animação. O método Load não dá suporte ao download de . Arquivos ACS de um site HTTP.

Carregar um caractere não exibe automaticamente o caractere. Use o método Show primeiro para tornar o caractere visível.