Compartilhar via


ScCopyNotifications

Aplica-se a: Outlook 2013 | Outlook 2016

Copia um grupo de notificações de evento para um único bloco de memória.

Propriedade Valor
Arquivo de cabeçalho:
Mapiutil.h
Implementado por:
MAPI
Chamado por:
Aplicativos cliente e provedores de serviços
SCODE ScCopyNotifications(
  int cntf,
  LPNOTIFICATION rgntf,
  LPVOID pvDst,
  ULONG FAR * pcb
);

Parâmetros

cntf

[in] Contagem de estruturas notification na matriz indicada pelo parâmetro rgntf .

rgntf

[in] Ponteiro para uma matriz de estruturas notification definindo as notificações de evento a serem copiadas.

pvDst

[out] Ponteiro para as notificações retornadas.

Pcb

[out] Ponteiro opcional para uma variável em que o tamanho, em bytes, da matriz apontada pelo parâmetro rgntf é armazenado. Se não for NULL, o parâmetro pcb será definido como o número de bytes armazenados no parâmetro pvDst .

Valor de retorno

S_OK

As notificações de evento foram copiadas com êxito.

E_INVALIDARG

Uma notificação inválida foi encontrada.

Comentários

Se NULL for passado no parâmetro do pcb , nenhuma cópia será executada; se um valor não nulo for passado no pcb, a função ScCopyNotifications copiará o tamanho da matriz e a própria matriz para um único bloco de memória. Se o pcb não for NULL, ele será definido como o número de bytes armazenados no parâmetro pvDst . O parâmetro pvDst deve ser grande o suficiente para conter toda a matriz.