IPersistFile::Load

Artigo
09/09/2008

Windows Mobile Supported Windows Embedded CE Supported

9/8/2008

Esse método abre o arquivo especificado e inicializa um objeto do conteúdo de arquivo.

Syntax

HRESULT Load(
  LPCOLESTR pszFileName,
  DWORD dwMode 
);

Parameters

pszFileName
[no] Aponta para um seqüência de caracteres zero-Terminated contendo a caminho absoluto do arquivo para aberto.

dwMode
[no] Especifica algumas combinações de valores da enumeração de STGM para indicar o modo de acesso para usar ao abrir o arquivo.

IPersistFile::Load pode tratar esse valor como uma sugestão, adicionando permissões mais restritivas se necessário.

Se dwMode for zero, a implementação deve aberto o arquivo usando qualquer permissões usar como padrão são usadas quando um usuário abre o arquivo.

Return Value

S_OK
O objeto foi carregado com êxito.

E_OUTOFMEMORY
O objeto não pôde ser carregado devido a uma falta de memória.

E_FAIL
O objeto não pôde ser carregado por algum motivo que não seja a falta de memória.

IPersistFile::Load Códigos de erro STG_E_ * também podem ser retornados.

Remarks

IPersistFile::Load Carrega o objeto a partir de arquivo especificado. Este método é para inicialização apenas e não apresentação o objeto para o usuário. Não é equivalente ao que ocorre quando um usuário seleciona o comando File Open.

Para determinar se a plataforma oferece suporte a esta interface, consulte Determinando suporte COM APIs.

Notas para chamadores

O BindToObject método no arquivo monikers chama esse método para carregar um objeto durante uma operação ligação moniker (quando um objeto vinculado é executar). Normalmente, os aplicativos não chamar este método diretamente.

Notas para Implementers

Porque as informações necessárias para um arquivo aberto varia bastante de um aplicativo para outro, o objeto no qual esse método está implementado deve também aberto o arquivo especificado pelo pszFileName parâmetro.

Isto difere de IPersistStorage::Load e IPersistStream::Load, na qual o chamador abre o armazenamento ou transmitir e, em seguida, passa um aberto armazenamento ou transmitir ponteiro para o objeto carregado.

Para um aplicativo que usa geralmente OLE composto arquivos, seu IPersistFile::Load implementação pode simplesmente chamar a StgOpenStorage função para aberto o objeto armazenamento no arquivo especificado. Em seguida, você pode proceder com padrão inicialização. Aplicativos que não usam objetos armazenamento podem padrão executar procedimentos Arquivo-Abrir.

Quando o objeto tenha sido carregado, sua implementação deve registrar o objeto na Running Object Table (consulte IRunningObjectTable::Register).

Requirements

Header	objidl.h, objidl.idl
Library	ole32.lib, uuid.lib
Windows Embedded CE	Windows CE 3.0 and later
Windows Mobile	Windows Mobile Version 5.0 and later

Compartilhar via