Função OleCreateFromFile (ole.h)

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