PromoteObjects Method

Description

Promotes unmanaged objects to managed objects.

Syntax

Visual Basic
Public Function PromoteObjects( _ ByVal ObjVers As ObjVers, _ ByVal pIPropertyValuesOfMultipleObjects As PropertyValuesOfMultipleObjectsEx, _ Optional ByVal ACLEnforcingMode As MFACLEnforcingMode = MFACLEnforcingModeAutomatic, _ Optional ByVal pACLProvidedCBN As AccessControlList = 0 _ ) As ObjectVersionAndPropertiesOfMultipleObjects

Visual Basic

Public Function PromoteObjects( _
   ByVal ObjVers As ObjVers, _
   ByVal pIPropertyValuesOfMultipleObjects As PropertyValuesOfMultipleObjectsEx, _
   Optional ByVal ACLEnforcingMode As MFACLEnforcingMode = MFACLEnforcingModeAutomatic, _
   Optional ByVal pACLProvidedCBN As AccessControlList = 0 _
) As ObjectVersionAndPropertiesOfMultipleObjects

Parameters

ObjVers

The unmanaged objects to promote.

pIPropertyValuesOfMultipleObjects

The new properties for the object versions.

ACLEnforcingMode

Value	Description
MFACLEnforcingModeAutomatic	The ACL previously stored for the object is used as the provided ACL.
MFACLEnforcingModeNone	The object ACL remains untouched.
MFACLEnforcingModeProvided	The ACL provided by the caller is used.
MFACLEnforcingModeResetToDefault	The ACL calculated from the properties is used as the provided ACL.

The ACL enforcing mode.

pACLProvidedCBN

The ACL provided by the user. Can be NULL if the enforcing mode is not MFACLEnforcingModeProvided.

Remarks

Supported in M-Files 21.11.10853.5 and later.

This method is available only if M-Files API is used in the server interface mode.