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

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

Confira também

StgIsStorageILockBytes