IStorage 中的名稱

發行項
06/13/2023

屬性集是以 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 不是已知的值，請使用下列程式，以演算法方式形成字串名稱。

以演算法方式形成字串名稱

視需要將 FMTID 轉換為小數位節順序。
採用 FMTID 的 128 位，並將它們視為一個長位字串，方法是將每個位元組串連在一起。 128 位值的第一個位是 FMTID 記憶體中第一個位元組的最小有效位;128 位值的最後一個位是 FMTID 記憶體中最後一個位元組的最大有效位。將兩個零位新增至結尾，將這些 128 位擴充至 130 位。
將 130 位分成五個位的群組;這類群組會有 26 個。將每個群組視為具有反向位優先順序的整數。例如，128 位的第一個位是五位之第一個群組的最小有效位;第五個 128 位是第一個群組的最顯著位。
將這些整數對應為三十二個字元陣列的索引：ABCDEFGHIJKLMNOPQRSTUVWXYZ012345。這會產生 26 個 Unicode 字元序列，只使用大寫字元和數位。區分大小寫和不區分大小寫的考慮不適用，導致每個字元在任何地區設定中都是唯一的。
將字串「\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 元素存在，則會使用它。否則，開啟會失敗。

建立新的屬性集時，上述對應會決定使用的字串名稱。

共用方式為

IStorage 中的名稱

將屬性集從 FMTID 轉換為字串名稱

將屬性集從字串名稱轉換為 FMTID

意見反應

其他資源