IStorage 中的名称

  • 项目

属性集使用 IPropertySetStorage 接口中的 FMTID) (格式标识符进行标识。 在 IStorage 接口中，属性集以 null 结尾的 Unicode 字符串命名，最大长度为 32 个字符。 若要实现互操作性，必须在 FMTID 与相应的以 null 结尾的 Unicode 字符串之间建立映射。

将属性集从 FMTID 转换为字符串名称

从 FMTID 转换为相应的 Unicode 字符串名称时，首先验证 FMTID 是否为下表中列出的已知值。 如果是，请使用相应的已知字符串名称。

FMTID 字符串名称 语义
F29F85E0-4FF9-1068-AB91-08002B27B3D9 “\005SummaryInformation” COM2 摘要信息
D5CDD502-2E9C-101B-9397-08002B2CF9AE D5CDD505-2E9C-101B-9397-08002B2CF9AE
 “\005DocumentSummaryInformation” Office 文档摘要信息和用户定义的属性。

注意

DocumentSummaryInformation 和 UserDefined 属性集是唯一的，因为它包含两个部分。 不允许在任何其他属性集中使用多个节。 有关详细信息，请参阅 结构化存储序列化属性集格式和 DocumentSummaryInformation 和 UserDefined 属性集。 第一部分定义为 COM 的一部分;第二个由 Microsoft Office 定义。

如果 FMTID 不是已知值，请使用以下过程在算法上形成字符串名称。

以算法形式形成字符串名称

  1. 如有必要，将 FMTID 转换为 little-endian 字节顺序。
  2. 取 FMTID 的 128 位，并通过将每个字节串联在一起，将它们视为一个长位字符串。 128 位值的第一位是 FMTID 内存中第一个字节的最小有效位;128 位值的最后一位是 FMTID 内存中最后一个字节的最有效位。 通过将两个零位添加到末尾，将这些 128 位扩展到 130 位。
  3. 将 130 位划分为 5 位组;将有26个这样的团体。 将每个组视为具有反向位优先级的整数。 例如，128 位中的第一个是第一组 5 位中的最小有效位;128 位中的第五个是第一组中最重要的位。
  4. 将每个整数作为索引映射到 32 个字符的数组中：ABCDEFGHIJKLMNOPQRSTUVWXYZ012345。 这会生成 26 个 Unicode 字符的序列，这些字符仅使用大写字符和数字。 区分大小写和不区分大小写的注意事项不适用，导致每个字符在任何区域设置中都是唯一的。
  5. 通过将字符串“\005”连接到这 26 个字符的前面来创建最终字符串，总长度为 27 个字符。

以下示例代码演示如何从 FMTID 映射到属性字符串。

#define CBIT_BYTE        8
#define CBIT_CHARMASK    5
#define CCH_MAP          (1 << CBIT_CHARMASK)    // 32
#define CHARMASK         (CCH_MAP - 1)           // 0x1f
 
CHAR awcMap[CCH_MAP + 1] = "abcdefghijklmnopqrstuvwxyz012345";
 
WCHAR MapChar(ULONG I) {
    return((WCHAR) awcMap[i & CHARMASK]);
    }
 
VOID GuidToPropertyStringName(GUID *pguid, WCHAR awcname[]) {
    BYTE *pb = (BYTE *) pguid;
    BYTE *pbEnd = pb + sizeof(*pguid);
    ULONG cbitRemain = CBIT_BYTE;
    WCHAR *pwc = awcname;
 
    *pwc++ = ((WCHAR) 0x0005);
    while (pb < pbEnd) {
        ULONG i = *pb >> (CBIT_BYTE - cbitRemain);
        if (cbitRemain >= CBIT_CHARMASK) {
            *pwc = MapChar(i);
            if (cbitRemain == CBIT_BYTE && 
                                    *pwc >= L'a' && *pwc <= L'z')
                {
                *pwc += (WCHAR) (L'A' - L'a');
                }
            pwc++;
            cbitRemain -= CBIT_CHARMASK;
            if (cbitRemain == 0) {
                pb++;
                cbitRemain = CBIT_BYTE;
                }
            }
        else {
            if (++pb < pbEnd) {
                i |= *pb << cbitRemain;
                }
            *pwc++ = MapChar(i);
            cbitRemain += CBIT_BYTE - CBIT_CHARMASK;
            }
        }
    *pwc = L'\0';
    }

将属性集从字符串名称转换为 FMTID

属性字符串名称到 GUID 的转换器应接受小写字母作为其大写对应项的同义词。

以下示例代码演示如何从属性字符串映射到 FMTID。

#include "stdafx.h"
#define _INC_OLE
#include <windows.h>
#include <stdlib.h>
#include <stdio.h>
#include <string.h>
#include <ctype.h>
#define CBIT_CHARMASK 5
#define CBIT_BYTE     8
#define CBIT_GUID    (CBIT_BYTE * sizeof(GUID))
#define CWC_PROPSET  (1 + (CBIT_GUID + CBIT_CHARMASK-1)/CBIT_CHARMASK)
#define WC_PROPSET0  ((WCHAR) 0x0005)
#define CCH_MAP      (1 << CBIT_CHARMASK)        // 32
#define CHARMASK     (CCH_MAP - 1)            // 0x1f
CHAR awcMap[CCH_MAP + 1] = "abcdefghijklmnopqrstuvwxyz012345";
#define CALPHACHARS  ('z' - 'a' + 1)

GUID guidSummary =
{ 0xf29f85e0,0x4ff9, 0x1068,
{ 0xab, 0x91, 0x08, 0x00, 0x2b, 0x27, 0xb3, 0xd9 } };

WCHAR wszSummary[] = L"SummaryInformation";

GUID guidDocumentSummary =
    { 0xd5cdd502,
      0x2e9c, 0x101b,
      { 0x93, 0x97, 0x08, 0x00, 0x2b, 0x2c, 0xf9, 0xae } };

WCHAR wszDocumentSummary[] = L"DocumentSummaryInformation";
__inline WCHAR

MapChar(IN ULONG i)
{
    return((WCHAR) awcMap[i & CHARMASK]);
}

ULONG PropertySetNameToGuid(
    IN ULONG cwcname,
    IN WCHAR const awcname[],
    OUT GUID *pguid)
{
    ULONG Status = ERROR_INVALID_PARAMETER;
    WCHAR const *pwc = awcname;

    if (pwc[0] == WC_PROPSET0)
    {
        //Note: cwcname includes the WC_PROPSET0, and
        //sizeof(wsz...) includes the trailing L'\0', but
        //the comparison excludes both the leading
        //WC_PROPSET0 and the trailing L'\0'.
        if (cwcname == sizeof(wszSummary)/sizeof(WCHAR) &&
            wcsnicmp(&pwc[1], wszSummary, cwcname - 1) == 0)
        {
            *pguid = guidSummary;
            return(NO_ERROR);
        }
        if (cwcname == CWC_PROPSET)
        {
            ULONG cbit;
            BYTE *pb = (BYTE *) pguid - 1;
            ZeroMemory(pguid, sizeof(*pguid));
            for (cbit = 0; cbit < CBIT_GUID; cbit += 
            CBIT_CHARMASK)
            {
                ULONG cbitUsed = cbit % CBIT_BYTE;
                ULONG cbitStored;
                WCHAR wc;
                if (cbitUsed == 0)
                {
                    pb++;
                }
                wc = *++pwc - L'A';        //assume uppercase
                if (wc > CALPHACHARS)
                {
                    wc += (WCHAR) (L'A' - L'a'); //try lowercase
                    if (wc > CALPHACHARS)
                    {
                        wc += L'a' - L'0' + CALPHACHARS; 
                        if (wc > CHARMASK)
                        {
                            goto fail;       //invalid character
                        }
                    }
                }
                *pb |= (BYTE) (wc << cbitUsed);
                cbitStored = min(CBIT_BYTE - cbitUsed, 
                CBIT_CHARMASK);

                //If the translated bits will not fit in the 
                //current byte
                if (cbitStored < CBIT_CHARMASK)
                {
                    wc >>= CBIT_BYTE - cbitUsed;
                    if (cbit + cbitStored == CBIT_GUID)
                    {
                       if (wc != 0)
                       {
                           goto fail;        //extra bits
                       }
                       break;
                    }
                    pb++;
                    *pb |= (BYTE) wc;
                }
           }
           Status = NO_ERROR;
      }
    }
fail:
    return(Status);
}

尝试在 IPropertySetStorage：：Open 中打开现有属性集时， (根) FMTID 转换为字符串，如上所述。 如果存在该名称的 IStorage 元素，则使用该元素。 否则，打开失败。

创建新属性集时，上述映射将确定使用的字符串名称。