IAgent::Carregar

[O Microsoft Agent foi preterido a partir do Windows 7 e pode não estar disponível em 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çãoCharacters.

• 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 de definição do caractere especificado.
URL	O endereço HTTP para o arquivo de definição do caractere.

 

pdwCharID

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

pdwReqID

Endereço de uma variável que recebe o Load ID de solicitação.

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

Não é possível carregar o mesmo caractere (um caractere com o mesmo GUID) mais de uma vez a partir de uma única conexão. Da mesma forma, não é possível carregar o caractere padrão e outros caracteres ao mesmo tempo a partir de uma única conexão, porque 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 oferece suporte ao carregamento de dados de caracteres 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 (. ACA). Geralmente, use o único estruturado . ACS para carregar um caractere armazenado em uma unidade de disco local ou rede e acessado usando o protocolo de arquivo convencional (como nomes de caminhos UNC). Use o arquivo separado . ACF e . 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 personagem; uma vez carregado, você pode usar o método Play para animar o personagem. Para . ACF, você também usa o método Prepare para carregar dados de animação. O método Load não suporta o download do . 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.