IPropData Interface

IID_IPropData

{0002031A-0000-0000-C000-000000000046}

The IPropData interface provides the ability to retrieve and change the access for an object's properties.

The IPropData::IMAPIProp interface is implemented by MAPI and used primarily by service providers that access this implementation by calling the CreateIProp function.

For more information about access levels on objects and properties, see Permissions for Objects and Properties.

Methods in VTable order

IUnknown Methods

Description

QueryInterface

Returns pointers to supported interfaces.

AddRef

Increments reference count.

Release

Decrements reference count.

IMAPIProp Methods

Description

GetLastError

Returns a MAPIERROR structure containing information about the previous error.

SaveChanges

Makes permanent any changes made to an object since the last save operation.

GetProps

Retrieves one or more properties.

GetPropList

Returns property tags for all properties.

OpenProperty

Returns a pointer to an interface to be used to access a property.

SetProps

Updates one or more properties.

DeleteProps

Deletes one or more properties.

CopyTo

Copies or moves all properties, except for specifically excluded properties.

CopyProps

Copies or moves selected properties.

GetNamesFromIDs

Provides the property names that correspond to one or more property identifiers.

GetIDsFromNames

Provides the property identifiers that correspond to one or more property names.

IPropData Methods

Description

HrSetObjAccess

Sets the access level for the object.

HrSetPropAccess

Sets the access level and status for one or more of the object's properties.

HrGetPropAccess

Retrieves the access level and status for one or more of the object's properties.

HrAddObjAccess

Adds one or more properties that are of type PT_OBJECT to the object.

HrSetObjectAccess

FUNCTION IPropData_HrSetObjAccess ( _
  BYVAL pIPropData AS DWORD PTR _
, BYVAL ulAccess AS DWORD _
  ) AS LONG

  LOCAL HRESULT AS LONG
  CALL DWORD @@pIPropData[14] USING IPropData_HrSetObjAccess (pIPropData, ulAccess) TO HRESULT
  FUNCTION = HRESULT

END FUNCTION

HrSetPropAccess

FUNCTION IPropData_HrSetPropAccess ( _
  BYVAL pIPropData AS DWORD PTR _
, BYVAL lpPropTagArray AS DWORD _
, BYVAL rgulAccess AS DWORD _
  ) AS LONG

  LOCAL HRESULT AS LONG
  CALL DWORD @@pIPropData[15] USING IPropData_HrSetPropAccess (pIPropData, lpPropTagArray, rgulAccess) TO HRESULT
  FUNCTION = HRESULT

END FUNCTION

HrGetPropAccess

FUNCTION IPropData_HrGetPropAccess ( _
  BYVAL pIPropData AS DWORD PTR _
, BYREF lppPropTagArray AS DWORD _
, BYREF lprgulAccess AS DWORD _
  ) AS LONG

  LOCAL HRESULT AS LONG
  CALL DWORD @@pIPropData[16] USING IPropData_HrGetPropAccess (pIPropData, lppPropTagArray, lprgulAccess) TO HRESULT
  FUNCTION = HRESULT

END FUNCTION

HrAddObjAccess

FUNCTION IPropData_HrAddObjProps ( _
  BYVAL pIPropData AS DWORD PTR _
, BYVAL lpPropTagArray AS DWORD _
, BYREF lppProblems AS DWORD _
  ) AS LONG

  LOCAL HRESULT AS LONG
  CALL DWORD @@pIPropData[17] USING IPropData_HrAddObjProps (pIPropData, lpPropTagArray, lppProblems) TO HRESULT
  FUNCTION = HRESULT

END FUNCTION