CSharedFile 类

项目
10/18/2023

支持共享内存文件的 CMemFile 派生类。

语法

class CSharedFile : public CMemFile

成员

公共构造函数

名称	描述
CSharedFile::CSharedFile	构造 `CSharedFile` 对象。

公共方法

名称	描述
CSharedFile::Detach	关闭共享内存文件并返回其内存块的句柄。
CSharedFile::SetHandle	将共享内存文件附加到内存块。

注解

内存文件的行为类似于磁盘文件。不同之处在于，内存文件存储在 RAM 中，而不是磁盘上。对于快速临时存储或在独立进程之间传输原始字节或序列化对象，内存文件非常有用。

共享内存文件与其他内存文件不同，因为前者的内存是使用 GlobalAlloc Windows 函数分配的。 CSharedFile 类将数据存储在全局分配的内存块（使用 GlobalAlloc 创建）中，并且可以使用 DDE、剪贴板或其他 OLE/COM 统一数据传输操作（例如，使用 IDataObject）共享此内存块。

GlobalAlloc 返回 HGLOBAL 句柄，而不是指向内存的指针（例如由 malloc 返回的指针）。某些应用程序中需要 HGLOBAL 句柄。例如，若要将数据放在剪贴板上，则需要 HGLOBAL 句柄。

CSharedFile 不使用内存映射的文件，并且数据不能在进程之间直接共享。

CSharedFile 对象可自动分配自己的内存。或者，你可调用 CSharedFile::SetHandle 将自己的内存块附加到 CSharedFile 对象。无论是哪种情况，如果 nGrowBytes 不为零，都按 nGrowBytes 大小的增量分配用于自动扩展内容文件的内存。

有关详细信息，请参阅运行时库参考中的文章 MFC 中的文件和文件处理。

继承层次结构

CObject

CFile

CMemFile

CSharedFile

要求

标头：afxadv.h

CSharedFile::CSharedFile

构造一个 CSharedFile 对象并为其分配内存。

CSharedFile(
    UINT nAllocFlags = GMEM_DDESHARE | GMEM_MOVEABLE,
    UINT nGrowBytes = 4096);

参数

nAllocFlags
指示如何分配内存的标志。有关有效标志值的列表，请参阅 GlobalAlloc。

nGrowBytes
内存分配增量（以字节为单位）。

CSharedFile::Detach

调用此函数以关闭内存文件，并将其从内存块中分离出来。

HGLOBAL Detach();

返回值

包含内存文件内容的内存块的句柄。

备注

可通过使用由 Detach 返回的句柄调用 SetHandle 来重新打开它。

CSharedFile::SetHandle

调用此函数以将全局内存块附加到 CSharedFile 对象。

void SetHandle(
    HGLOBAL hGlobalMemory,
    BOOL bAllowGrow = TRUE);

参数

hGlobalMemory
要附加到 CSharedFile 的全局内存的句柄。

bAllowGrow
指定是否允许内存块增长。

注解

如果 bAllowGrow 不为零，则内存块的大小将根据需要（例如，如果尝试将超过内存块大小的更多字节写入文件）增加。

另请参阅

CMemFile 类
 层次结构图
 CMemFile 类

通过