Compartilhar via


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