{"id":2403,"date":"2006-02-27T11:56:00","date_gmt":"2006-02-27T11:56:00","guid":{"rendered":"https:\/\/blogs.msdn.microsoft.com\/heaths\/2006\/02\/27\/identifying-windows-installer-file-types\/"},"modified":"2006-02-27T11:56:00","modified_gmt":"2006-02-27T11:56:00","slug":"identifying-windows-installer-file-types","status":"publish","type":"post","link":"https:\/\/devblogs.microsoft.com\/setup\/identifying-windows-installer-file-types\/","title":{"rendered":"Identifying Windows Installer File Types"},"content":{"rendered":"

I’ve been writing a number of helpful tools at work such as a tool to extract transforms and cabinets from a patch<\/a> and wasn’t satisfied relying on the file extension to identify a patch, or other Windows Installer file types for that matter. File extensions are only one way to help the shell to invoke actions on files, filter file types in common dialogs, and more.<\/p>\n

If you try to open an .msp<\/i> file with the MsiOpenDatabase<\/code> function<\/a> you must pass the MSIDBOPEN_PATCHFILE<\/code> flag to the szPersist<\/code> parameter or the function fails. Passing this flag for other Windows Installer file types also results in an error, and this function cannot be used to open .msi<\/i> files. Changing the file extension makes no difference. Obviously something more helps Windows Installer functions validate that files are of a certain type.<\/p>\n

Recall from What’s in a Patch<\/a> that Windows Installer relies on OLE structure storage. Embedded transforms are stored as sub-storage while embedded cabinets and binary data fields are streams. Sub-storages are identified by class identifiers (CLSID<\/code>s) you can get using structured storages functions. You can open any of the supported Windows Installer types with the StgOpenStorage<\/code><\/a> and the StgOpenStorageEx<\/code><\/a> functions. This provides a pointer to the IStorage<\/code> interface<\/a>, and with the pointer we can call the IStorage::Stat<\/code> method<\/a>. That provides a STATSTG<\/code> structure<\/a> that contains the CLSID<\/code> for the storage. If you compare the CLSID<\/code> values for the various Windows Installer file types, you’ll find a few differences as seen in the table below.<\/p>\n\n\n\n\n\n\n\n\n\n
\n

Description<\/b><\/p>\n<\/td>\n

\n

Extension<\/b><\/p>\n<\/td>\n

\n

CLSID<\/b><\/p>\n<\/td>\n<\/tr>\n<\/thead>\n

\n

Installer Package<\/p>\n<\/td>\n

\n

msi<\/p>\n<\/td>\n

\n

{000C1084-0000-0000-C000-000000000046}<\/code><\/p>\n<\/td>\n<\/tr>\n

\n

Merge Module<\/p>\n<\/td>\n

\n

msm<\/p>\n<\/td>\n

\n

{000C1084-0000-0000-C000-000000000046}<\/code><\/p>\n<\/td>\n<\/tr>\n

\n

Patch Package<\/p>\n<\/td>\n

\n

msp<\/p>\n<\/td>\n

\n

{000C1086-0000-0000-C000-000000000046}<\/code><\/p>\n<\/td>\n<\/tr>\n

\n

Transform<\/p>\n<\/td>\n

\n

mst<\/p>\n<\/td>\n

\n

{000C1082-0000-0000-C000-000000000046}<\/code><\/p>\n<\/td>\n<\/tr>\n

\n

Patch Creation Properties<\/p>\n<\/td>\n

\n

pcp<\/p>\n<\/td>\n

\n

{000C1084-0000-0000-C000-000000000046}<\/code><\/p>\n<\/td>\n<\/tr>\n<\/tbody>\n<\/table>\n

Keep in mind that this information could change any time. That said, the Windows Installer team is typically pretty good about maintaining backward compatibility. To discover this information, example code follows.<\/p>\n

HRESULT hr = NOERROR;
LPSTORAGE pStorage = NULL;
STATSTG stg = { 0 };
const int<\/font> cchCLSID = 40;
OLECHAR szCLSID[cchCLSID];<\/p>\n

\/\/ Argument validation excluded for brevity.<\/font><\/p>\n

\/\/ Open the storage file exclusively. Files like MSPs seem to require this flag.<\/font>
hr = StgOpenStorage(argv[1], NULL, STGM_SHARE_EXCLUSIVE, NULL, 0, &pStorage);
if<\/font> (SUCCEEDED(hr) && pStorage)
{
    \/\/ Get the stats for the storage document.<\/font>
    pStorage->Stat(&stg, STATFLAG_DEFAULT);
    
    \/\/ Print STATSTG.clsid.<\/font>
    if (StringFromGUID2(stg.clsid, szCLSID, cchCLSID))
    {
        wprintf(L“%sn”<\/font>, szCLSID);
    }
    
    CoTaskMemFree(stg.pwcsName);
    pStorage->Release();
    pStorage = NULL;
}<\/font><\/p>\n

For use in C and C++ source code, example definitions follow:<\/p>\n

EXTERN_C const<\/font> CLSID CLSID_MsiTransform = {0xC1082, 0x0, 0x0, {0xC0, 0x0, 0x0, 0x0, 0x0, 0x0, 0x0, 0x46}};
EXTERN_C const<\/font> CLSID CLSID_MsiPackage = {0xC1084, 0x0, 0x0, {0xC0, 0x0, 0x0, 0x0, 0x0, 0x0, 0x0, 0x46}};
EXTERN_C const<\/font> CLSID CLSID_MsiPatch = {0xC1086, 0x0, 0x0, {0xC0, 0x0, 0x0, 0x0, 0x0, 0x0, 0x0, 0x46}};<\/font><\/p>\n

You can download<\/a> the full implementation for a tool to print all STATSTG<\/code> fields for structured storage files using the compound file implementation<\/a>.<\/p><\/p>\n","protected":false},"excerpt":{"rendered":"

I’ve been writing a number of helpful tools at work such as a tool to extract transforms and cabinets from a patch and wasn’t satisfied relying on the file extension to identify a patch, or other Windows Installer file types for that matter. File extensions are only one way to help the shell to invoke […]<\/p>\n","protected":false},"author":389,"featured_media":3843,"comment_status":"open","ping_status":"closed","sticky":false,"template":"","format":"standard","meta":{"_acf_changed":false,"footnotes":""},"categories":[1],"tags":[14,20],"class_list":["post-2403","post","type-post","status-publish","format-standard","has-post-thumbnail","hentry","category-uncategorized","tag-development","tag-installation"],"acf":[],"blog_post_summary":"

I’ve been writing a number of helpful tools at work such as a tool to extract transforms and cabinets from a patch and wasn’t satisfied relying on the file extension to identify a patch, or other Windows Installer file types for that matter. File extensions are only one way to help the shell to invoke […]<\/p>\n","_links":{"self":[{"href":"https:\/\/devblogs.microsoft.com\/setup\/wp-json\/wp\/v2\/posts\/2403","targetHints":{"allow":["GET"]}}],"collection":[{"href":"https:\/\/devblogs.microsoft.com\/setup\/wp-json\/wp\/v2\/posts"}],"about":[{"href":"https:\/\/devblogs.microsoft.com\/setup\/wp-json\/wp\/v2\/types\/post"}],"author":[{"embeddable":true,"href":"https:\/\/devblogs.microsoft.com\/setup\/wp-json\/wp\/v2\/users\/389"}],"replies":[{"embeddable":true,"href":"https:\/\/devblogs.microsoft.com\/setup\/wp-json\/wp\/v2\/comments?post=2403"}],"version-history":[{"count":0,"href":"https:\/\/devblogs.microsoft.com\/setup\/wp-json\/wp\/v2\/posts\/2403\/revisions"}],"wp:featuredmedia":[{"embeddable":true,"href":"https:\/\/devblogs.microsoft.com\/setup\/wp-json\/wp\/v2\/media\/3843"}],"wp:attachment":[{"href":"https:\/\/devblogs.microsoft.com\/setup\/wp-json\/wp\/v2\/media?parent=2403"}],"wp:term":[{"taxonomy":"category","embeddable":true,"href":"https:\/\/devblogs.microsoft.com\/setup\/wp-json\/wp\/v2\/categories?post=2403"},{"taxonomy":"post_tag","embeddable":true,"href":"https:\/\/devblogs.microsoft.com\/setup\/wp-json\/wp\/v2\/tags?post=2403"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}