PropCopyMore

Aplica-se a: Outlook 2013 | Outlook 2016

Copia um único valor de propriedade de um local de origem para um local de destino.

Propriedade	Valor
Arquivo de cabeçalho:	Mapiutil.h
Implementado por:	MAPI
Chamado por:	Aplicativos cliente e provedores de serviços

SCODE PropCopyMore(
  LPSPropValue lpSPropValueDest,
  LPSPropValue lpSPropValueSrc,
  ALLOCATEMORE * lpfAllocMore,
  LPVOID lpvObject
);

Parâmetros

lpSPropValueDest

[out] Ponteiro para o local ao qual essa função grava uma estrutura SPropValue definindo o valor da propriedade copiada.

lpSPropValueSrc

[in] Ponteiro para a estrutura SPropValue que contém o valor da propriedade a ser copiado.

lpfAllocMore

[in] Ponteiro para a função MAPIAllocateMore a ser usada para alocar memória adicional se o local de destino não for grande o suficiente para manter a propriedade a ser copiada.

lpvObject

[in] Ponteiro para um objeto para o qual MAPIAllocateMore alocará espaço, se necessário.

Valor de retorno

S_OK

O valor da propriedade única foi copiado com êxito.

MAPI_E_NO_SUPPORT

Um tipo de propriedade desconhecido foi encontrado.

Comentários

Um aplicativo cliente ou provedor de serviços pode usar a função PropCopyMore para copiar uma propriedade de uma tabela que está prestes a ser liberada para usá-la em outro lugar.

O PropCopyMore não precisa alocar memória a menos que o valor da propriedade copiado seja de um tipo, como PT_STRING8, que não se encaixe em uma estrutura SPropValue . Para essas propriedades grandes, a função aloca memória usando a função MAPIAllocateMore para a qual um ponteiro é passado no parâmetro lpfAllocMore .

Uso imprudente da memória de fragmentos PropCopyMore ; considere usar a função ScCopyProps em vez disso.