GetClassFile

9/8/2008

Essa função fornece o identificador classe associado com o nome de arquivo especificado.

Syntax

WINOLEAPI GetClassFile( 
  LPCWSTR szFileName, 
  CLSID* pclsid
);

Parameters

• szFileName
  [no] Seqüência de caracteres NULL-Terminated que contém o nome arquivo para o qual você está solicitando o associado identificador classe.

• pclsid
  [out] Ponteiro para a localidade onde o associado identificador classe é gravado no retorno.

Return Value

Um dos valores descritos a seguinte tabela é retornada.

Valor	Descrição
S_OK	Indica que o identificador classe foi fornecida com êxito.
MK_E_CANTOPENFILE	Não é possível indica o nome especificado arquivo aberto.
MK_E_INVALIDEXTENSION	Indica a extensão especificada no Registro é inválido.

Essa função também pode retornar erros sistema de arquivos.

Remarks

Quando recebe um nome arquivo, o GetClassFile função localiza o identificador classe associado com esse arquivo. Um exemplo de seu uso está na implementação de OLE de IMoniker::BindToObject. Isso chama GetClassFile Para localizar o aplicativo objeto que pode aberto o arquivo quando um link para um documento File-Based está ativado.

O GetClassFile função procura a chave File Extension em de Registro que corresponde ao.ext parte do nome do arquivo. Se a entrada banco de dados contém um válido identificador classe, essa função retorna esse identificador classe.

Se a chave File Extension não é encontrado ou a entrada banco de dados contém um inválido identificador classe, a função retorna MK_E_INVALIDEXTENSION.

Para determinar se a plataforma oferece suporte a essa função, consulte Determinando suporte COM APIs.

Requirements

Header	objbase.h
Library	ole32.lib
Windows Embedded CE	Windows CE 2.10 and later
Windows Mobile	Windows Mobile Version 5.0 and later

See Also

Reference

IMoniker::BindToObject
StringFromCLSID
WriteClassStg