SHAllocShared, fonction (shlwapi.h)

[SHAllocShared est disponible pour une utilisation dans les systèmes d’exploitation spécifiés dans la section Exigences. 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 à copier. Vous pouvez définir ce paramètre sur NULL si vous souhaitez partager un bloc de mémoire sans 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 NULL en cas d’échec.

Remarques

Utilisez SHFreeShared pour libérer le handle lorsque vous avez terminé.

Spécifications

Voir aussi

SHFreeShared

SHLockShared

SHUnlockShared