//+-------------------------------------------------------------------------- // // Microsoft Windows // Copyright (C) Microsoft Corporation, 1993 // // File: ntprop.cxx // // Contents: OLE Appendix B property set support. // // History: 28-Nov-94 vich created // 15-Jul-96 MikeHill - PropSetNames: WCHAR=>OLECHAR, byte-swapping. // - Added special-cases for PictureIt! propsets. // //--------------------------------------------------------------------------- #include #include //#include //#include // These optionally-compiled directives tell the compiler & debugger // where the real file, rather than the copy, is located. #ifdef _ORIG_FILE_LOCATION_ #if __LINE__ != 25 #error File heading has change size #else #line 29 "\\nt\\private\\dcomidl\\ntprop.cxx" #endif #endif #define CCH_MAP (1 << CBIT_CHARMASK) // 32 #define CHARMASK (CCH_MAP - 1) // 0x1f // we use static array instead of string literals because some systems // have 4 bytes string literals, and would not produce the correct result // for REF's 2 byte Unicode convention // OLECHAR aocMap[CCH_MAP + 1] = {'a','b','c','d','e','f','g', 'h','i','j','k','l','m','n', 'o','p','q','r','s','t','u', 'v','w','x','y','z', '0','1','2','3','4','5','\0'}; #define CALPHACHARS (1 + (OLECHAR)'z' - (OLECHAR)'a') GUID guidSummary = { 0xf29f85e0, 0x4ff9, 0x1068, { 0xab, 0x91, 0x08, 0x00, 0x2b, 0x27, 0xb3, 0xd9 } }; OLECHAR oszSummary[] = {'S','u','m','m','a','r','y', 'I','n','f','o','r','m','a','t','i','o','n','\0'}; GUID guidDocumentSummary = { 0xd5cdd502, 0x2e9c, 0x101b, { 0x93, 0x97, 0x08, 0x00, 0x2b, 0x2c, 0xf9, 0xae } }; OLECHAR oszDocumentSummary[] = {'D','o','c','u','m','e','n','t', 'S','u','m','m','a','r','y', 'I','n','f','o','r','m','a','t','i','o','n', '\0'}; // Note that user defined properties are placed in section 2 with the below // GUID as the FMTID -- alas, we did not expect Office95 to actually use it. GUID guidDocumentSummarySection2 = { 0xd5cdd505, 0x2e9c, 0x101b, { 0x93, 0x97, 0x08, 0x00, 0x2b, 0x2c, 0xf9, 0xae } }; // *Global Info* OLECHAR oszGlobalInfo[] = {'G','l','o','b','a','l',' ','I','n','f','o','\0'}; GUID guidGlobalInfo = { 0x56616F00, 0xC154, 0x11ce, { 0x85, 0x53, 0x00, 0xAA, 0x00, 0xA1, 0xF9, 0x5B } }; // *Image Contents* OLECHAR oszImageContents[] = {'I','m','a','g','e',' ', 'C','o','n','t','e','n','t','s','\0'}; GUID guidImageContents = { 0x56616400, 0xC154, 0x11ce, { 0x85, 0x53, 0x00, 0xAA, 0x00, 0xA1, 0xF9, 0x5B } }; // *Image Info* OLECHAR oszImageInfo[] = {'I','m','a','g','e',' ','I','n','f','o','\0'}; GUID guidImageInfo = { 0x56616500, 0xC154, 0x11ce, { 0x85, 0x53, 0x00, 0xAA, 0x00, 0xA1, 0xF9, 0x5B } }; __inline OLECHAR MapChar(IN ULONG i) { return((OLECHAR) aocMap[i & CHARMASK]); } //+-------------------------------------------------------------------------- // Function: RtlGuidToPropertySetName // // Synopsis: Map property set GUID to null-terminated UNICODE name string. // // The awcname parameter is assumed to be a buffer with room for // CWC_PROPSETSZ (28) UNICODE characters. The first character // is always WC_PROPSET0 (0x05), as specified by the OLE Appendix // B documentation. The colon character normally used as an NT // stream name separator is not written to the caller's buffer. // // No error is possible. // // Arguments: IN GUID *pguid -- pointer to GUID to convert // OUT OLECHAR aocname[] -- output string buffer // // Returns: count of non-NULL characters in the output string buffer //--------------------------------------------------------------------------- ULONG PROPSYSAPI PROPAPI RtlGuidToPropertySetName( IN GUID const *pguid, OUT OLECHAR aocname[]) { ULONG cbitRemain = CBIT_BYTE; OLECHAR *poc = aocname; BYTE *pb; BYTE *pbEnd; *poc++ = OC_PROPSET0; // ----------------------- // Check for special-cases // ----------------------- // Note: CCH_PROPSET includes the OC_PROPSET0, and sizeof(osz...) // includes the trailing '\0', so sizeof(osz...) is ok because the // OC_PROPSET0 character compensates for the trailing NULL character. // Is this the SummaryInformation propset? PROPASSERT(CCH_PROPSET >= sizeof(oszSummary)/sizeof(OLECHAR)); if (*pguid == guidSummary) { RtlCopyMemory(poc, oszSummary, sizeof(oszSummary)); return(sizeof(oszSummary)/sizeof(OLECHAR)); } // Is this The DocumentSummaryInformation or User-Defined propset? PROPASSERT(CCH_PROPSET >= sizeof(oszDocumentSummary)/sizeof(OLECHAR)); if (*pguid == guidDocumentSummary || *pguid == guidDocumentSummarySection2) { RtlCopyMemory(poc, oszDocumentSummary, sizeof(oszDocumentSummary)); return(sizeof(oszDocumentSummary)/sizeof(OLECHAR)); } // Is this the Global Info propset? PROPASSERT(CCH_PROPSET >= sizeof(oszGlobalInfo)/sizeof(OLECHAR)); if (*pguid == guidGlobalInfo) { RtlCopyMemory(poc, oszGlobalInfo, sizeof(oszGlobalInfo)); return(sizeof(oszGlobalInfo)/sizeof(OLECHAR)); } // Is this the Image Contents propset? PROPASSERT(CCH_PROPSET >= sizeof(oszImageContents)/sizeof(OLECHAR)); if (*pguid == guidImageContents) { RtlCopyMemory(poc, oszImageContents, sizeof(oszImageContents)); return(sizeof(oszImageContents)/sizeof(OLECHAR)); } // Is this the Image Info propset? PROPASSERT(CCH_PROPSET >= sizeof(oszImageInfo)/sizeof(OLECHAR)); if (*pguid == guidImageInfo) { RtlCopyMemory(poc, oszImageInfo, sizeof(oszImageInfo)); return(sizeof(oszImageInfo)/sizeof(OLECHAR)); } // ------------------------------ // Calculate the string-ized GUID // ------------------------------ // If this is a big-endian system, we need to convert // the GUID to little-endian for the conversion. #if BIGENDIAN GUID guidByteSwapped = *pguid; PropByteSwap( &guidByteSwapped ); pguid = &guidByteSwapped; #endif // Point to the beginning and ending of the GUID pb = (BYTE*) pguid; pbEnd = pb + sizeof(*pguid); // Walk 'pb' through each byte of the GUID. while (pb < pbEnd) { ULONG i = *pb >> (CBIT_BYTE - cbitRemain); if (cbitRemain >= CBIT_CHARMASK) { *poc = MapChar(i); if (cbitRemain == CBIT_BYTE && *poc >= (OLECHAR)'a' && *poc <= ((OLECHAR)'z')) { *poc += (OLECHAR) ( ((OLECHAR)'A') - ((OLECHAR)'a') ); } poc++; cbitRemain -= CBIT_CHARMASK; if (cbitRemain == 0) { pb++; cbitRemain = CBIT_BYTE; } } else { if (++pb < pbEnd) { i |= *pb << cbitRemain; } *poc++ = MapChar(i); cbitRemain += CBIT_BYTE - CBIT_CHARMASK; } } // while (pb < pbEnd) *poc = OLESTR( '\0' ); return(CCH_PROPSET); } //+-------------------------------------------------------------------------- // Function: RtlPropertySetNameToGuid // // Synopsis: Map non null-terminated UNICODE string to a property set GUID. // // If the name is not properly formed as per // RtlGuidToPropertySetName(), STATUS_INVALID_PARAMETER is // returned. The pguid parameter is assumed to point to a buffer // with room for a GUID structure. // // Arguments: IN ULONG cocname -- count of OLECHARs in string to convert // IN OLECHAR aocname[] -- input string to convert // OUT GUID *pguid -- pointer to buffer for converted GUID // // Returns: NTSTATUS //--------------------------------------------------------------------------- NTSTATUS PROPSYSAPI PROPAPI RtlPropertySetNameToGuid( IN ULONG cocname, IN OLECHAR const aocname[], OUT GUID *pguid) { NTSTATUS Status = STATUS_INVALID_PARAMETER; OLECHAR const *poc = aocname; if (poc[0] == OC_PROPSET0) { // ----------------------- // Check for Special-Cases // ----------------------- // Note: cocname includes the OC_PROPSET0, and sizeof(osz...) // includes the trailing OLESTR('\0'), but the comparison excludes both // the leading OC_PROPSET0 and the trailing '\0'. // Is this SummaryInformation? if (cocname == sizeof(oszSummary)/sizeof(OLECHAR) && ocsnicmp(&poc[1], oszSummary, cocname - 1) == 0) { *pguid = guidSummary; return(STATUS_SUCCESS); } // Is this DocumentSummaryInformation? if (cocname == sizeof(oszDocumentSummary)/sizeof(OLECHAR) && ocsnicmp(&poc[1], oszDocumentSummary, cocname - 1) == 0) { *pguid = guidDocumentSummary; return(STATUS_SUCCESS); } // Is this Global Info? if (cocname == sizeof(oszGlobalInfo)/sizeof(OLECHAR) && ocsnicmp(&poc[1], oszGlobalInfo, cocname - 1) == 0) { *pguid = guidGlobalInfo; return(STATUS_SUCCESS); } // Is this Image Info? if (cocname == sizeof(oszImageInfo)/sizeof(OLECHAR) && ocsnicmp(&poc[1], oszImageInfo, cocname - 1) == 0) { *pguid = guidImageInfo; return(STATUS_SUCCESS); } // Is this Image Contents? if (cocname == sizeof(oszImageContents)/sizeof(OLECHAR) && ocsnicmp(&poc[1], oszImageContents, cocname - 1) == 0) { *pguid = guidImageContents; return(STATUS_SUCCESS); } // ------------------ // Calculate the GUID // ------------------ // None of the special-cases hit, so we must calculate // the GUID from the name. if (cocname == CCH_PROPSET) { ULONG cbit; BYTE *pb = (BYTE *) pguid - 1; RtlZeroMemory(pguid, sizeof(*pguid)); for (cbit = 0; cbit < CBIT_GUID; cbit += CBIT_CHARMASK) { ULONG cbitUsed = cbit % CBIT_BYTE; ULONG cbitStored; OLECHAR oc; if (cbitUsed == 0) { pb++; } oc = *++poc - (OLECHAR)'A'; // assume upper case // for wchar (unsigned) -ve values becomes a large number // but for char, which is signed, -ve is -ve if (oc > CALPHACHARS || oc < 0) { // oops, try lower case oc += (OLECHAR) ( ((OLECHAR)'A') - ((OLECHAR)'a')); if (oc > CALPHACHARS || oc < 0) { // must be a digit oc += ((OLECHAR)'a') - ((OLECHAR)'0') + CALPHACHARS; if (oc > CHARMASK) { goto Exit; // invalid character } } } *pb |= (BYTE) (oc << cbitUsed); cbitStored = min(CBIT_BYTE - cbitUsed, CBIT_CHARMASK); // If the translated bits wouldn't all fit in the current byte if (cbitStored < CBIT_CHARMASK) { oc >>= CBIT_BYTE - cbitUsed; if (cbit + cbitStored == CBIT_GUID) { if (oc != 0) { goto Exit; // extra bits } break; } pb++; *pb |= (BYTE) oc; } } // for (cbit = 0; cbit < CBIT_GUID; cbit += CBIT_CHARMASK) Status = STATUS_SUCCESS; // If byte-swapping is necessary, do so now on the calculated // GUID. PropByteSwap( pguid ); } // if (cocname == CCH_PROPSET) } // if (poc[0] == OC_PROPSET0) // ---- // Exit // ---- Exit: return(Status); }