Функция SHAllocShared (shlwapi.h)

[SHAllocShared доступен для использования в операционных системах, указанных в разделе "Требования". Он может быть изменен или недоступен в последующих версиях.]

Выделяет дескриптор в указанном процессе копии указанного блока памяти в вызывающем процессе.

Синтаксис

HANDLE SHAllocShared(
  [in, optional] const void *pvData,
  [in]           DWORD      dwSize,
  [in]           DWORD      dwProcessId
);

Параметры

[in, optional] pvData

Тип: const void*

Указатель на блок памяти в процессе вызова, который необходимо скопировать. Этот параметр можно задать значение NULL , если вы хотите предоставить общий доступ к блоку памяти без копирования данных в него.

[in] dwSize

Тип: DWORD

Размер блока памяти в байтах, на который указывает pvData.

[in] dwProcessId

Тип: DWORD

Идентификатор процесса, который будет совместно использовать блок памяти, указанный pvData.

Возвращаемое значение

Тип: HANDLE

Возвращает дескриптор общей памяти для процесса, указанного dwDestinationProcessId. Возвращает значение NULL , если не удалось.

Замечания

Используйте SHFreeShared , чтобы освободить дескриптор после завершения работы.

Требования

См. также

SHFreeShared

SHLockShared

SHUnlockShared