Compartilhar via


ScCountNotifications

Aplica-se a: Outlook 2013 | Outlook 2016

Determina o tamanho, em bytes, de uma matriz de notificações de evento e valida a memória associada à matriz.

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

Parâmetros

cntf

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

rgntf

[in] Ponteiro para a matriz de estruturas NOTIFICATION cujo tamanho deve ser determinado.

Pcb

[out] Ponteiro opcional para o tamanho, em bytes, da matriz apontada pelo parâmetro rgntf . Se NULL, ScCountNotifications validar a matriz de notificações.

Valor de retorno

S_OK

A contagem foi determinada com êxito.

MAPI_E_INVALID_PARAMETER

Uma notificação inválida foi encontrada.

Comentários

Se NULL for passado no parâmetro pcb , a função ScCountNotifications só validará a matriz de notificações, mas nenhuma contagem será feita; se um valor não nulo for passado no pcb, ScCountNotifications determinará o tamanho da matriz e armazenará o pcb de causa. O parâmetro pcb deve ser grande o suficiente para conter toda a matriz.