414 lines
12 KiB
C
414 lines
12 KiB
C
/*++
|
|
|
|
Copyright (c) 1992 Microsoft Corporation
|
|
|
|
Module Name:
|
|
|
|
win31io.h
|
|
|
|
Abstract:
|
|
|
|
This header file contains the Win 3.1 Group/REG.DAT data
|
|
structure definitions, as well as the 32 bit group definitions.
|
|
Why these aren't in the shell32.dll somewhere I don't know
|
|
|
|
Author:
|
|
|
|
Steve Wood (stevewo) 22-Feb-1993
|
|
|
|
Revision History:
|
|
|
|
--*/
|
|
|
|
#ifndef _WIN31IO_
|
|
#define _WIN31IO_
|
|
|
|
#include "win31evt.h"
|
|
|
|
typedef struct GROUP_DEF {
|
|
union {
|
|
DWORD dwMagic; /* magical bytes 'PMCC' */
|
|
DWORD dwCurrentSize; /* During conversion only */
|
|
};
|
|
WORD wCheckSum; /* adjust this for zero sum of file */
|
|
WORD cbGroup; /* length of group segment (does NOT include tags) */
|
|
RECT rcNormal; /* rectangle of normal window */
|
|
POINT ptMin; /* point of icon */
|
|
WORD nCmdShow; /* min, max, or normal state */
|
|
WORD pName; /* name of group */
|
|
/* these four change interpretation */
|
|
WORD cxIcon; /* width of icons */
|
|
WORD cyIcon; /* hieght of icons */
|
|
WORD wIconFormat; /* planes and BPP in icons */
|
|
WORD wReserved; /* This word is no longer used. */
|
|
/* Used internally to hold total size of group, including tags */
|
|
WORD cItems; /* number of items in group */
|
|
WORD rgiItems[1]; /* array of ITEMDEF offsets */
|
|
} GROUP_DEF, *PGROUP_DEF;
|
|
|
|
#define NSLOTS 16 /* initial number of items entries */
|
|
|
|
typedef struct ITEM_DEF {
|
|
POINT pt; /* location of item icon in group */
|
|
WORD idIcon; /* id of item icon */
|
|
WORD wIconVer; /* icon version */
|
|
WORD cbIconRes; /* size of icon resource */
|
|
WORD indexIcon; /* index of item icon */
|
|
WORD dummy2; /* - not used anymore */
|
|
WORD pIconRes; /* offset of icon resource */
|
|
WORD dummy3; /* - not used anymore */
|
|
WORD pName; /* offset of name string */
|
|
WORD pCommand; /* offset of command string */
|
|
WORD pIconPath; /* offset of icon path */
|
|
} ITEM_DEF, *PITEM_DEF;
|
|
|
|
|
|
/* the pointers in the above structures are short pointers relative to the
|
|
* beginning of the segments. This macro converts the short pointer into
|
|
* a long pointer including the proper segment/selector value. It assumes
|
|
* that its argument is an lvalue somewhere in a group segment, for example,
|
|
* PTR(lpgd->pName) returns a pointer to the group name, but k=lpgd->pName;
|
|
* PTR(k) is obviously wrong as it will use either SS or DS for its segment,
|
|
* depending on the storage class of k.
|
|
*/
|
|
#define PTR( base, offset ) (LPSTR)((PBYTE)base + offset)
|
|
|
|
/* this macro is used to retrieve the i-th item in the group segment. Note
|
|
* that this pointer will NOT be NULL for an unused slot.
|
|
*/
|
|
#define ITEM( lpgd, i ) ((PITEM_DEF)PTR( lpgd, lpgd->rgiItems[i] ))
|
|
|
|
#define VER31 0x030A
|
|
#define VER30 0x0300
|
|
#define VER20 0x0201
|
|
|
|
/*--------------------------------------------------------------------------*/
|
|
/* */
|
|
/* Tag Stuff */
|
|
/* */
|
|
/*--------------------------------------------------------------------------*/
|
|
|
|
typedef struct _TAG_DEF {
|
|
WORD wID; // tag identifier
|
|
WORD dummy1; // need this for alignment!
|
|
int wItem; // (unde the covers 32 bit point!)item the tag belongs to
|
|
WORD cb; // size of record, including id and count
|
|
WORD dummy2; // need this for alignment!
|
|
BYTE rgb[1];
|
|
} TAG_DEF, *PTAG_DEF;
|
|
|
|
#define GROUP_MAGIC 0x43434D50L /* 'PMCC' */
|
|
#define PMTAG_MAGIC GROUP_MAGIC
|
|
|
|
/* range 8000 - 80FF > global
|
|
* range 8100 - 81FF > per item
|
|
* all others reserved
|
|
*/
|
|
|
|
#define ID_MAINTAIN 0x8000
|
|
/* bit used to indicate a tag that should be kept even if the writer
|
|
* doesn't recognize it.
|
|
*/
|
|
|
|
#define ID_MAGIC 0x8000
|
|
/* data: the string 'TAGS'
|
|
*/
|
|
|
|
#define ID_WRITERVERSION 0x8001
|
|
/* data: string in the form [9]9.99[Z].99
|
|
*/
|
|
|
|
#define ID_APPLICATIONDIR 0x8101
|
|
/* data: ASCIZ string of directory where application may be
|
|
* located.
|
|
* this is defined as application dir rather than default dir
|
|
* since the default dir is explicit in the 3.0 command line and
|
|
* must stay there. The true "new information" is the application
|
|
* directory. If not present, search the path.
|
|
*/
|
|
|
|
#define ID_HOTKEY 0x8102
|
|
/* data: WORD hotkey index
|
|
*/
|
|
|
|
#define ID_MINIMIZE 0x8103
|
|
/* data none
|
|
*/
|
|
|
|
#define ID_LASTTAG 0xFFFF
|
|
/* the last tag in the file
|
|
*/
|
|
|
|
/*
|
|
* Maximium number of items allowed in a group
|
|
*/
|
|
#define CITEMSMAX 50
|
|
|
|
|
|
/*
|
|
* Maximium number of groups allowed in PROGMAN
|
|
*/
|
|
|
|
#define CGROUPSMAX 40
|
|
|
|
/*--------------------------------------------------------------------------*/
|
|
/*--------------------------------------------------------------------------*/
|
|
|
|
//
|
|
// This is the structure of the .grp files in Windows3.1
|
|
//
|
|
|
|
/* .GRP File format structures -
|
|
*/
|
|
typedef struct _GROUP_DEF16 {
|
|
DWORD dwMagic; /* magical bytes 'PMCC' */
|
|
WORD wCheckSum; /* adjust this for zero sum of file */
|
|
WORD cbGroup; /* length of group segment (does NOT include tags) */
|
|
WORD nCmdShow; /* min, max, or normal state */
|
|
SMALL_RECT rcNormal; /* rectangle of normal window */
|
|
POINTS ptMin; /* point of icon */
|
|
WORD pName; /* name of group */
|
|
/* these four change interpretation */
|
|
WORD cxIcon; /* width of icons */
|
|
WORD cyIcon; /* hieght of icons */
|
|
WORD wIconFormat; /* planes and BPP in icons */
|
|
WORD wReserved; /* This word is no longer used. */
|
|
/* Used internally to hold total size of group, including tags */
|
|
|
|
WORD cItems; /* number of items in group */
|
|
WORD rgiItems[1]; /* array of ITEMDEF offsets */
|
|
} GROUP_DEF16, *PGROUP_DEF16;
|
|
|
|
/* this macro is used to retrieve the i-th item in the group segment. Note
|
|
* that this pointer will NOT be NULL for an unused slot.
|
|
*/
|
|
#define ITEM16( lpgd16, i ) ((PITEM_DEF16)PTR( lpgd16, lpgd16->rgiItems[i] ))
|
|
|
|
//
|
|
// These structures are not needed for the conversion but it is useful to
|
|
// understand what is going on.
|
|
//
|
|
typedef struct _ITEM_DEF16 {
|
|
POINTS pt; /* location of item icon in group */
|
|
WORD iIcon; /* index of item icon */
|
|
WORD cbHeader; /* size of icon header */
|
|
WORD cbANDPlane; /* size of and part of icon */
|
|
WORD cbXORPlane; /* size of xor part of icon */
|
|
WORD pHeader; /* file offset of icon header */
|
|
WORD pANDPlane; /* file offset of AND plane */
|
|
WORD pXORPlane; /* file offset of XOR plane */
|
|
WORD pName; /* file offset of name string */
|
|
WORD pCommand; /* file offset of command string */
|
|
WORD pIconPath; /* file offset of icon path */
|
|
} ITEM_DEF16, *PITEM_DEF16;
|
|
|
|
|
|
typedef struct _CURSORSHAPE_16 {
|
|
WORD xHotSpot;
|
|
WORD yHotSpot;
|
|
WORD cx;
|
|
WORD cy;
|
|
WORD cbWidth; /* Bytes per row, accounting for word alignment. */
|
|
BYTE Planes;
|
|
BYTE BitsPixel;
|
|
} CURSORSHAPE_16, *PCURSORSHAPE_16;
|
|
|
|
|
|
|
|
typedef struct _TAG_DEF16 {
|
|
WORD wID; // tag identifier
|
|
WORD wItem; // item the tag belongs to
|
|
WORD cb; // size of record, including id and count
|
|
BYTE rgb[1];
|
|
} TAG_DEF16, *PTAG_DEF16;
|
|
|
|
typedef struct _ICON_HEADER16 {
|
|
WORD xHotSpot;
|
|
WORD yHotSpot;
|
|
WORD cx;
|
|
WORD cy;
|
|
WORD cbWidth; /* Bytes per row, accounting for word alignment. */
|
|
BYTE Planes;
|
|
BYTE BitsPixel;
|
|
} ICON_HEADER16, *PICON_HEADER16;
|
|
|
|
|
|
#pragma pack(2)
|
|
|
|
typedef struct _REG_KEY16 { // key nodes
|
|
WORD iNext; // next sibling key
|
|
WORD iChild; // first child key
|
|
WORD iKey; // string defining key
|
|
WORD iValue; // string defining value of key-tuple
|
|
} REG_KEY16, *PREG_KEY16;
|
|
|
|
typedef struct _REG_STRING16 {
|
|
WORD iNext; // next string in chain
|
|
WORD cRef; // reference count
|
|
WORD cb; // length of string
|
|
WORD irgb; // offset in string segment
|
|
} REG_STRING16, *PREG_STRING16;
|
|
|
|
typedef union _REG_NODE16 { // a node may be...
|
|
REG_KEY16 key; // a key
|
|
REG_STRING16 str; // a string
|
|
} REG_NODE16, *PREG_NODE16;
|
|
|
|
typedef struct _REG_HEADER16 {
|
|
DWORD dwMagic; // magic number
|
|
DWORD dwVersion; // version number
|
|
DWORD dwHdrSize; // size of header
|
|
DWORD dwNodeTable; // offset of node table
|
|
DWORD dwNTSize; // size of node table
|
|
DWORD dwStringValue; // offset of string values
|
|
DWORD dwSVSize; // size of string values
|
|
WORD nHash; // number of initial string table entries
|
|
WORD iFirstFree; // first free node
|
|
} REG_HEADER16, *PREG_HEADER16;
|
|
|
|
#define MAGIC_NUMBER 0x43434853L // 'SHCC'
|
|
#define VERSION_NUMBER 0x30312E33L // '3.10'
|
|
|
|
#pragma pack()
|
|
|
|
//
|
|
// Routines defined in group32.c
|
|
//
|
|
|
|
ULONG
|
|
QueryNumberOfPersonalGroupNames(
|
|
HANDLE CurrentUser,
|
|
PHANDLE GroupNamesKey,
|
|
PHANDLE SettingsKey
|
|
);
|
|
|
|
BOOL
|
|
NewPersonalGroupName(
|
|
HANDLE GroupNamesKey,
|
|
PWSTR GroupName,
|
|
ULONG GroupNumber
|
|
);
|
|
|
|
BOOL
|
|
DoesExistGroup(
|
|
HANDLE GroupsKey,
|
|
PWSTR GroupName
|
|
);
|
|
|
|
PGROUP_DEF
|
|
LoadGroup(
|
|
HANDLE GroupsKey,
|
|
PWSTR GroupFileName
|
|
);
|
|
|
|
BOOL
|
|
UnloadGroup(
|
|
PGROUP_DEF Group
|
|
);
|
|
|
|
|
|
BOOL
|
|
ExtendGroup(
|
|
PGROUP_DEF Group,
|
|
BOOL AppendToGroup,
|
|
DWORD cb
|
|
);
|
|
|
|
WORD
|
|
AddDataToGroup(
|
|
PGROUP_DEF Group,
|
|
PBYTE Data,
|
|
DWORD cb
|
|
);
|
|
|
|
BOOL
|
|
AddTagToGroup(
|
|
PGROUP_DEF Group,
|
|
WORD wID,
|
|
WORD wItem,
|
|
WORD cb,
|
|
PBYTE rgb
|
|
);
|
|
|
|
PGROUP_DEF
|
|
CreateGroupFromGroup16(
|
|
LPSTR GroupName,
|
|
PGROUP_DEF16 Group16
|
|
);
|
|
|
|
BOOL
|
|
SaveGroup(
|
|
HANDLE GroupsKey,
|
|
PWSTR GroupName,
|
|
PGROUP_DEF Group
|
|
);
|
|
|
|
BOOL
|
|
DeleteGroup(
|
|
HANDLE GroupsKey,
|
|
PWSTR GroupName
|
|
);
|
|
|
|
#if DBG
|
|
BOOL
|
|
DumpGroup(
|
|
PWSTR GroupFileName,
|
|
PGROUP_DEF Group
|
|
);
|
|
#endif
|
|
|
|
|
|
//
|
|
// Routines defined in group16.c
|
|
//
|
|
|
|
PGROUP_DEF16
|
|
LoadGroup16(
|
|
PWSTR GroupFileName
|
|
);
|
|
|
|
BOOL
|
|
UnloadGroup16(
|
|
PGROUP_DEF16 Group
|
|
);
|
|
|
|
#if DBG
|
|
BOOL
|
|
DumpGroup16(
|
|
PWSTR GroupFileName,
|
|
PGROUP_DEF16 Group
|
|
);
|
|
#endif
|
|
|
|
|
|
|
|
//
|
|
// Routines defined in regdat16.c
|
|
//
|
|
|
|
PREG_HEADER16
|
|
LoadRegistry16(
|
|
PWSTR RegistryFileName
|
|
);
|
|
|
|
BOOL
|
|
UnloadRegistry16(
|
|
PREG_HEADER16 Registry
|
|
);
|
|
|
|
BOOL
|
|
CreateRegistryClassesFromRegistry16(
|
|
HANDLE SoftwareRoot,
|
|
PREG_HEADER16 Registry
|
|
);
|
|
|
|
#if DBG
|
|
BOOL
|
|
DumpRegistry16(
|
|
PREG_HEADER16 Registry
|
|
);
|
|
#endif
|
|
|
|
|
|
#endif // _WIN31IO_
|