IPropData::HrGetPropAccess
Aplica-se a: Outlook 2013 | Outlook 2016
Recupera o n�vel de acesso e o status de uma ou mais das propriedades do objeto.
HRESULT HrGetPropAccess(
LPSPropTagArray FAR * lppPropTagArray,
ULONG FAR * FAR * lprgulAccess
);
Parâmetros
lppPropTagArray
[al�m, out] Na entrada, uma matriz de marcas de propriedade que indicam as propriedades para o qual recuperar os n�veis de acesso e o status; Caso contr�rio, um ponteiro para nulo, o que indica que HrGetPropAccess deve recuperar o status para todas as propriedades e os n�veis de acesso. Na sa�da, uma matriz de marcas de propriedade para a quais sinalizadores de acesso e o status foram recuperadas. Os sinalizadores são armazenados na matriz apontada pelo parâmetro lprgulAccess .
lprgulAccess
[out] Um ponteiro para uma matriz de m�scaras de bits de sinalizador. Cada bitmask indica os níveis de acesso ou status, ou ambos, para cada uma das propriedades identificadas na matriz apontada pelo parâmetro lpPropTagArray. As duas matrizes são posicionais na qual o primeiro bitmask que lprgulAccess aponta para descreve a primeira propriedade para a qual lpPropTagArray aponta e assim por diante. Para cada marca de propriedade, os sinalizadores a seguir podem ser definidos:
| Sinalizador de n�vel de acesso | Sinalizador de status |
|---|---|
| IPROP_READONLY, que indica que a propriedade n�o pode ser modificada. | IPROP_CLEAN, que indica que a propriedade n�o foi modificada. |
| IPROP_READWRITE, que indica que a propriedade pode ser modificada. | IPROP_DIRTY, que indica que a propriedade foi modificada. |
Valor de retorno
S_OK
Os sinalizadores de status e o n�vel de acesso para as propriedades foram retornados com �xito.
Comentários
O m�todo IPropData::HrGetPropAccess recupera um conjunto de sinalizadores que indica o n�vel de acesso e o status de uma ou mais propriedades.
Observações para chamadores:
Voc� pode usar HrGetPropAccess para as seguintes finalidades:
Para determinar se um cliente alterados ou exclu�dos de uma propriedade grav�vel.
Para impedir que um cliente de alterar ou excluir uma propriedade usando os m�todos IMAPIProp .
Se uma das propriedades na matriz de marcas de propriedade apontada por lppPropTagArray tiver sido excluída, HrGetPropAccess definirá a entrada da matriz como 0 na saída. Se você definir lppPropTagArray como NULL e uma das propriedades do objeto tiver sido excluída, a propriedade excluída será retornada na matriz.
Se uma propriedade tiver sido modificada, seu sinalizador IPROP_DIRTY será definido na entrada correspondente na matriz à qual lprgulAccess aponta. Nem IPROP_READONLY nem IPROP_READWRITE ser� definido.
Se uma propriedade n�o foi modificada ou exclu�da, somente o sinalizador IPROP_READONLY ou IPROP_READWRITE ser� definido.