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.