PromoteObject Method

Description

Promotes an unmanaged object to a managed one.

Syntax

Visual Basic
Public Function PromoteObject( _ ByVal ObjVer As ObjVer, _ ByVal PropertyValues As PropertyValues, _ Optional ByVal ACLEnforcingMode As MFACLEnforcingMode = MFACLEnforcingModeAutomatic, _ Optional ByVal pACLProvidedCBN As AccessControlList = 0 _ ) As ObjectVersionAndProperties

Visual Basic

Public Function PromoteObject( _
   ByVal ObjVer As ObjVer, _
   ByVal PropertyValues As PropertyValues, _
   Optional ByVal ACLEnforcingMode As MFACLEnforcingMode = MFACLEnforcingModeAutomatic, _
   Optional ByVal pACLProvidedCBN As AccessControlList = 0 _
) As ObjectVersionAndProperties

Parameters

ObjVer

The unmanaged object to be promoted.

PropertyValues

The new properties for the object version.

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 set to "MFACLEnforcingModeProvided".

Remarks

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