Функция 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 , чтобы освободить дескриптор после завершения.
Требования
| Требование | Значение |
|---|---|
| Минимальная версия клиента | Windows XP [только классические приложения] |
| Минимальная версия сервера | Windows Server 2003 [только классические приложения] |
| Целевая платформа | Windows |
| Header | shlwapi.h |
| DLL | Shlwapi.dll |