Share via

Função SHAllocShared (shlwapi.h)

  • Artigo

[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 por pvData.

Retornar valor

Tipo: HANDLE

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

Comentários

Use SHFreeShared para liberar o identificador quando terminar.

Requisitos

Requisito Valor
Cliente mínimo com suporte Windows XP [somente aplicativos da área de trabalho]
Servidor mínimo com suporte Windows Server 2003 [somente aplicativos da área de trabalho]
Plataforma de Destino Windows
Cabeçalho shlwapi.h
DLL Shlwapi.dll

Confira também

SHFreeShared

SHLockShared

SHUnlockShared