Função OleCreateFromFile (ole.h)

  • Artigo

Cria um objeto inserido com base no conteúdo de um arquivo nomeado.

Sintaxe

OLESTATUS OleCreateFromFile(
  LPCSTR        unnamedParam1,
  LPOLECLIENT   unnamedParam2,
  LPCSTR        unnamedParam3,
  LPCSTR        unnamedParam4,
  LHCLIENTDOC   unnamedParam5,
  LPCSTR        unnamedParam6,
  LPOLEOBJECT   *unnamedParam7,
  OLEOPT_RENDER unnamedParam8,
  OLECLIPFORMAT unnamedParam9
);

Parâmetros

unnamedParam1

TBD

unnamedParam2

TBD

unnamedParam3

TBD

unnamedParam4

TBD

unnamedParam5

TBD

unnamedParam6

TBD

unnamedParam7

TBD

unnamedParam8

TBD

unnamedParam9

TBD

Retornar valor

Essa função retorna S_OK em caso de êxito. Outros valores possíveis incluem o seguinte.

Código de retorno Descrição
STG_E_FILENOTFOUND
Arquivo não associado.
OLE_E_CANT_BINDTOSOURCE
 Não é possível associar à origem.
STG_E_MEDIUMFULL
 O meio está cheio.
DV_E_TYMED
 TYMED inválido.
DV_E_LINDEX
 LINDEX inválido.
DV_E_FORMATETC
 Estrutura FORMATETC inválida.

Comentários

A função OleCreateFromFile cria um novo objeto inserido com base no conteúdo de um arquivo nomeado. Se o ProgID no banco de dados de registro contiver a chave PackageOnFileDrop, ele criará um pacote. Caso contrário, a função chama a função GetClassFile para obter o CLSID associado ao parâmetro lpszFileName e, em seguida, cria um objeto incorporado OLE 2 associado a esse CLSID. O parâmetro rclsid de OleCreateFromFile sempre será ignorado e deverá ser definido como CLSID_NULL.

Quanto a outras funções OleCreateXxx, o objeto recém-criado não é mostrado ao usuário para edição, o que requer uma operação DoVerb . Ele é usado para implementar operações de inserção de arquivo.

Requisitos

Requisito Valor
Cliente mínimo com suporte Windows 2000 Professional [somente aplicativos da área de trabalho]
Servidor mínimo com suporte Windows 2000 Server [somente aplicativos da área de trabalho]
Plataforma de Destino Windows
Cabeçalho ole.h (inclua Ole2.h)
Biblioteca Ole32.lib
DLL Ole32.dll

Confira também

Getclassfile