Função SHAllocShared (shlwapi.h)

[SHAllocShared está disponível para uso nos sistemas operacionais especificados na seção Requisitos. Ele pode estar alterado ou indisponível em versões subsequentes.]

Aloca um identificador em um processo especificado para uma cópia de um bloco de memória especificado no processo de chamada.

Sintaxe

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

Parâmetros

[in, optional] pvData

Tipo: const void*

Um ponteiro para o bloco de memória no processo de chamada que deve ser copiado. Você pode definir esse parâmetro como NULL se quiser compartilhar um bloco de memória sem copiar nenhum dado para ele.

[in] dwSize

Tipo: DWORD

O tamanho, em bytes, do bloco de memória apontado por pvData.

[in] dwProcessId

Tipo: DWORD

A ID do processo que compartilhará o bloco de memória especificado pelo pvData.

Valor de retorno

Tipo: HANDLE

Retorna um identificador para a memória compartilhada para o processo especificado por dwDestinationProcessId. Retorna NULL se não tiver êxito.

Observações

Use SHFreeShared para liberar o identificador quando terminar.

Requirements

Consulte também

SHFreeShared

SHLockShared

SHUnlockShared