Fonction SHAllocShared (shlwapi.h)
[SHAllocShared est disponible pour une utilisation dans les systèmes d’exploitation spécifiés dans la section Configuration requise. Il peut être modifié ou indisponible dans les versions suivantes.]
Alloue un handle dans un processus spécifié à une copie d’un bloc de mémoire spécifié dans le processus appelant.
Syntaxe
HANDLE SHAllocShared(
[in, optional] const void *pvData,
[in] DWORD dwSize,
[in] DWORD dwProcessId
);
Paramètres
[in, optional] pvData
Type : const void*
Pointeur vers le bloc de mémoire dans le processus appelant qui doit être copié. Vous pouvez définir ce paramètre sur NULL si vous souhaitez partager un bloc de mémoire sans y copier de données.
[in] dwSize
Type : DWORD
Taille, en octets, du bloc de mémoire pointé par pvData.
[in] dwProcessId
Type : DWORD
ID de processus du processus qui partagera le bloc de mémoire spécifié par pvData.
Valeur retournée
Type : HANDLE
Retourne un handle à la mémoire partagée pour le processus spécifié par dwDestinationProcessId. Retourne la valeur NULL en cas d’échec.
Remarques
Utilisez SHFreeShared pour libérer le handle lorsque vous avez terminé.
Configuration requise
| Condition requise | Valeur |
|---|---|
| Client minimal pris en charge | Windows XP [applications de bureau uniquement] |
| Serveur minimal pris en charge | Windows Server 2003 [applications de bureau uniquement] |
| Plateforme cible | Windows |
| En-tête | shlwapi.h |
| DLL | Shlwapi.dll |