Função StgIsStorageFile (coml2api.h)

A função StgIsStorageFile indica se um arquivo de disco específico contém um objeto de armazenamento.

Sintaxe

HRESULT StgIsStorageFile(
  [in] const WCHAR *pwcsName
);

Parâmetros

[in] pwcsName

Ponteiro para o nome da cadeia de caracteres Unicode terminada em nulo do arquivo de disco a ser examinado. O parâmetro pwcsName é passado desinterpretado para o sistema de arquivos subjacente.

Retornar valor

A função StgIsStorageFile também pode retornar erros do sistema de arquivos ou erros do sistema encapsulados em um HRESULT. Consulte Estratégias de tratamento de erros e tratamento de erros desconhecidos

Comentários

No início do arquivo de disco subjacente a um objeto de armazenamento está uma assinatura que distingue um objeto de armazenamento de outros formatos de arquivo. A função StgIsStorageFile é útil para aplicativos cujos documentos usam um formato de arquivo de disco que pode ou não usar objetos de armazenamento.

Se um arquivo composto raiz tiver sido criado no modo transacionado, mas ainda não confirmado, esse método ainda retornará S_OK.

Requisitos

Confira também

StgIsStorageILockBytes