ScCopyProps
Aplica-se a: Outlook 2013 | Outlook 2016
Copia as propriedades definidas por uma matriz de estruturas SPropValue para um novo destino.
| Propriedade | Valor |
|---|---|
| Arquivo de cabeçalho: |
Mapiutil.h |
| Implementado por: |
MAPI |
| Chamado por: |
Aplicativos cliente e provedores de serviços |
SCODE ScCopyProps(
int cprop,
LPSPropValue rgprop,
LPVOID pvDst,
ULONG FAR * pcb
);
Parâmetros
cprop
[in] Contagem de propriedades a serem copiadas.
rgprop
[in] Ponteiro para uma matriz de estruturas SPropValue que definem as propriedades a serem copiadas. O parâmetro rgprop não precisa apontar para o início da matriz, mas deve apontar para o início de uma das estruturas SPropValue na matriz.
pvDst
[in] Ponteiro para a posição inicial na memória à qual essa função copia as propriedades.
Pcb
[out] Ponteiro opcional para o tamanho, em bytes, do bloco de memória apontado pelo parâmetro pvDst .
Valor de retorno
S_OK
As propriedades foram copiadas com êxito.
MAPI_E_INVALID_PARAMETER
Um tipo de propriedade desconhecido foi encontrado.
Comentários
A nova matriz e seus dados residem em um buffer criado com uma única alocação e a função ScRelocProps pode ser usada para ajustar os ponteiros nas estruturas individuais do SPropValue . Antes desse ajuste, os ponteiros são válidos.
ScCopyProps mantém a ordem de propriedade original para a matriz de propriedades copiada.
O parâmetro pcb é opcional; se não for NULL, ele será definido como o número de bytes armazenados no parâmetro pvDst .