ScCountProps
Aplica-se a: Outlook 2013 | Outlook 2016
Determina o tamanho, em bytes, de uma matriz de valor de propriedade 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 ScCountProps(
int cprop,
LPSPropValue rgprop,
ULONG FAR * pcb
);
Parâmetros
cprop
[in] Contagem de propriedades na matriz indicada pelo parâmetro rgprop .
rgprop
[in] Ponteiro para um intervalo em uma matriz de estruturas SPropValue que define as propriedades cujo tamanho deve ser determinado. Esse intervalo não é necessariamente iniciado no início da matriz.
Pcb
[out] Ponteiro opcional para o tamanho, em bytes, da matriz de propriedades.
Valor de retorno
S_OK
A chamada foi bem-sucedida e retornou o valor ou valores esperados.
MAPI_E_INVALID_PARAMETER
Pelo menos uma propriedade na matriz de valor da propriedade tem um identificador de PROP_ID_NULL ou PROP_ID_INVALID, ou a matriz de propriedades contém uma propriedade multivalida sem valores de propriedade.
Comentários
Se NULL for passado no parâmetro pcb , a função ScCountProps validará a matriz de notificações, mas nenhuma contagem será feita. Se um valor não nulo for passado no pcb, a função 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.
Como está contando, ScCountProps valida a memória associada à matriz. O ScCountProps funciona apenas com propriedades sobre as quais o MAPI tem informações.