IPropData::HrSetPropAccessIPropData::HrSetPropAccess

適用されます: OutlookApplies to: Outlook

�A�N�Z�X ���x���܂��̓I�u�W�F�N�g�̃v���p�e�B�� 1 �ˆȏ�̏�Ԃ�ݒ肵�܂��BSets the access level or status for one or more of the object's properties.

HRESULT HrSetPropAccess(
  LPSPropTagArray lpPropTagArray,
  ULONG FAR * rgulAccess
);

�p�����[�^�[Parameters

lpPropTagArraylpPropTagArray

[����]�v���p�e�B��ύX�ł��邱�Ƃ�����v���p�e�B �^�O�̔z��ւ̃|�C���^�[�B[in] A pointer to an array of property tags that indicate the properties to be modified.

rgulAccessrgulAccess

[����]�t���O �r�b�g�}�X�N�̔z�񂵂܂��B�e�r�b�g�́A�A�N�Z�X ���x���̏��]�A�܂��͂��̗����� _lpPropTagArray_�p�����[�^�[���Q�ƁA�z���̓���̃v���p�e�B�̊e���\������܂��B2 �‚̔z��A�ʒu _rgulAccess_�ōŏ��̃r�b�g�ɂ‚��Đ���ŏ��̃v���p�e�B�� _lpPropTagArray_�|�C���g�ɁA���̂ł��B �v���p�e�B�̃^�O���ƂɁA1 �‚̃A�N�Z�X ���x���̃t���O�� 1 �‚̃t���O��ݒ�ł��܂��B���̕\�́A�”\�ȃt���O������܂��B[in] An array of flag bitmasks. Each bitmask indicates the access levels or status, or both, for each of the properties identified in the array that the lpPropTagArray parameter points to. The two arrays are positional in that the first bitmask in rgulAccess describes the first property that lpPropTagArray points to, and so on. For each property tag, one access-level flag and one status flag can be set. The following table shows the possible flags.

�A�N�Z�X ���x���̃t���OAccess-level flag �t���O�̏��Status flag
�v���p�e�B��ύX�ł��Ȃ����Ƃ�����AIPROP_READONLYIPROP_READONLY, which indicates that the property cannot be modified
IPROP_CLEAN �v���p�e�B���ύX����Ă��Ȃ����Ƃ�����܂��BIPROP_CLEAN, which indicates that the property has not been modified.
IPROP_READWRITE �v���p�e�B��ύX�ł��邱�Ƃ�����܂��BIPROP_READWRITE, which indicates that the property can be modified.
IPROP_DIRTY �v���p�e�B���ύX����Ă��邱�Ƃ�����܂��BIPROP_DIRTY, which indicates that the property has been modified.

�߂�lReturn value

S_OKS_OK

�A�N�Z�X ���x���Ə�Ԃ̃t���O������ɐݒ肳��Ă��܂��BThe access-level and status flags have been successfully set.

MAPI_E_NO_ACCESSMAPI_E_NO_ACCESS

�ǂݎ���p�I�u�W�F�N�g�܂��͔��M�҂��\���ȃA�N�Z�X���‚�����Ă���I�u�W�F�N�g�̃v���p�e�B��ݒ肵�܂����BAn attempt was made to set a property on a read-only object or an object for which the caller has insufficient permissions.

MAPI_E_INVALID_PARAMETERMAPI_E_INVALID_PARAMETER

_rgulAccess_�p�����[�^�[�ɂ́A�t���O�AIPROP_READONLY IPROP_READWRITE �Ȃǂ̖����ȑg�ݍ��킹���܂܂�Ă��܂��BThe rgulAccess parameter contains an invalid combination of flags, such as IPROP_READONLY and IPROP_READWRITE.

����Remarks

IPropData::HrSetPropAccess���\�b�h�́A�A�N�Z�X ���x������� lpPropTagArray�p�����[�^�[��w��_SPropTagArray_�\���̃v���p�e�B �^�O�Ŏ��ʂ����v���p�e�B�̏�Ԃ�ύX���܂��B�e�v���p�e�B�ɂ� _rgulAccess_�z��őΉ�����G���g��������܂��B1 �‚̃t���O������v���p�e�B�̃A�N�Z�X ���x���ʂɁA�Y������G���g����ݒ�ł��܂���Ԃ�����t���O��ݒ肵�܂��BThe IPropData::HrSetPropAccess method changes the access level and status for the properties that are identified by the property tags in the SPropTagArray structure pointed to by the lpPropTagArray parameter. For each property, there is a corresponding entry in the rgulAccess array. The entry can be set to one flag that indicates the property's access level and another flag that indicates its status.

呼び出し側への注意Notes to callers

����̃v���p�e�B] �̒l���ύX���ꂽ�Ƃ��Ɍ��肵����A�I�u�W�F�N�g�̃v���p�e�B�� 1 �ˆȏ�̃A�N�Z�X ���x����ύX����̂ɂ́A HrSetPropAccess��g�p���܂��BUse HrSetPropAccess to determine when a particular property value changes and to change the access level for one or more of an object's properties.

�֘A����See also

SPropTagArraySPropTagArray

IPropData: IMAPIPropIPropData : IMAPIProp