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 |