| Previous | Next |
| S_ADS_NOMORE_COLUMNS | STG_S_BLOCK |
STG_S_CONVERTED
Successful conversion with a changed representation
STG_S_CONVERTED is a success HRESULT, but it carries more information than S_OK. It can result from STGM_CONVERT when an existing file, stream, or storage element is converted into COM structured storage. For IStorage::CreateStorage, an existing stream can become a storage that contains a stream named CONTENTS.
The caller must continue using the returned IStorage object and must not assume the underlying object retained its former flat representation.
What to verify
- Test HRESULTs with
SUCCEEDED/FAILED; comparison only withS_OKincorrectly rejects this result. - Record whether
STGM_CONVERT, direct mode, or transacted mode was used. - Reopen the converted object through structured-storage APIs instead of parsing it as the original flat file.
- Understand when conversion becomes durable: transaction and commit rules still apply to the returned storage.
References
Microsoft COM storage HRESULTs · IStorage::CreateStorage · Structured Storage overview
Looking for a different code? Search another status or error code.