关于STGMEDIUM中的CIDA结构体浅析

杭州浪子

于 2022-06-20 18:41:44 发布

阅读量377

点赞数

分类专栏： C++ 文章标签： c++ STGMEDIUM

本文链接：https://blog.csdn.net/Joy58061678/article/details/125378275

版权

C++ 专栏收录该内容

2 篇文章

订阅专栏

本文详细介绍了在Windows Shell Extension中遇到的CIDA（Compound ID List Array）结构体，以及如何填充和解析该结构体。通过setData方法，DataObject将FORMATETC数据和STGMEDIUM设置到CIDA内存中，其中包含了ParentIDList和IDList。CIDA的大小根据IDList数量变化，解析代码展示了如何获取ParentIDList和各个ITEMIDLIST。这是一个关于Windows系统编程和Shell扩展的知识点记录。

摘要生成于 C知道，由 DeepSeek-R1 满血版支持，前往体验 >

最近工作中碰到了在shell extension 中遇到了CIDA结构体。

DataObject通过setData的方式，将FORMATETC数据和STGMEDIUM设置到类中，而STGMEDIUM中是一块内存，涉及了CIDA结构体。

首先看下CIDA的结构体

typedef struct _IDA {
    UINT cidl;          // number of relative IDList
    UINT aoffset[1];    // [0]: folder IDList, [1]-[cidl]: item IDList
} CIDA, * LPIDA;

通过对该结构体数据的填充，最后将该内存拷贝到STGMEDIUM的hGlobal句柄上。

其数据填充如下：

首先cidl代表了要填充的ITEMIDLIST的数量。

aoffset代表了ITEMIDLIST内存起始的偏移量。

整块内存分布为：

CIDA + ParentIDList+ IDList+(0 0)以2个0结尾。

其中CIDA占用的长度是不定的，当IDList数量为1时，ICDA中的aoffset数组是2个，占用8字节，cidl占用4字节，即CIDA一共占用12字节，其中aoffset的2个UINT分别为ParentIDList偏移量和IDList的偏移量。

举个例子：

当ParentIDList长度为480字节，IDList长度为460字节。那么CIDA中的

aoffset[0]=12

aoffset[1]=492

解析代码为：

		LPIDA pida = (LPIDA)pmediumIn->hGlobal;

		CComPtr<IShellFolder> ppsf;
		LPCITEMIDLIST pidlParent = (LPCITEMIDLIST)(((LPBYTE)pida) + (pida)->aoffset[0]);

		hr = SHBindToObject(NULL, pidlParent, NULL, IID_PPV_ARGS(&ppsf));

		pidlList.resize(pida->cidl + 1);

		for (UINT i = 0; SUCCEEDED(hr) && i < pida->cidl + 1; i++) // +1, the parent element was first, and we are includeing it, it is also an PCIDLIST_ABSOLUTE
		{
			pidlList[i] = (LPCITEMIDLIST)(((LPBYTE)pida) + (pida)->aoffset[i]);
		}

暂时先记录到这里。后续有时间再跟进和贴图吧，