IPropData::HrSetPropAccess
Aplica-se a: Outlook 2013 | Outlook 2016
Define o n�vel de acesso ou o status de uma ou mais das propriedades do objeto.
HRESULT HrSetPropAccess(
LPSPropTagArray lpPropTagArray,
ULONG FAR * rgulAccess
);
Parâmetros
Lpproptagarray
[in] Um ponteiro para uma matriz de marcas de propriedade que indicam as propriedades a serem modificadas.
rgulAccess
[in] 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 à qual o parâmetro lpPropTagArray aponta. As duas matrizes são posicionais na qual o primeiro bitmask em rgulAccess descreve a primeira propriedade para a qual lpPropTagArray aponta e assim por diante. Para cada marca de propriedade, um sinalizador de n�vel de acesso e o sinalizador de status de um pode ser definido. A tabela a seguir mostra os sinalizadores poss�veis.
| 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 foram definidos com �xito.
MAPI_E_NO_ACCESS
Foi feita uma tentativa para definir uma propriedade em um objeto somente leitura ou de um objeto para o qual o chamador tem permiss�es insuficientes.
MAPI_E_INVALID_PARAMETER
O parâmetro rgulAccess contém uma combinação inválida de sinalizadores, como IPROP_READONLY e IPROP_READWRITE.
Comentários
O método IPropData::HrSetPropAccess altera o nível de acesso e status para as propriedades identificadas pelas marcas de propriedade na estrutura SPropTagArray apontada pelo parâmetro lpPropTagArray. Para cada propriedade, há uma entrada correspondente na matriz rgulAccess . A entrada pode ser definida como um sinalizador que indica o n�vel de acesso da propriedade e outro sinalizador que indica seu status.
Notas para chamadores
Use HrSetPropAccess para determinar quando um valor da propriedade espec�fica alterado e alterar o n�vel de acesso para uma ou mais das propriedades de um objeto.