GetPathInDefaultViewEx Method

If the target object exists with versions 1 and 2, the following table summarizes the L or S specific segments of the location path:

Flag value	Requested version 1	Requested version 2	Requested version -1
MFLatestSpecificBehaviorNormal	S/v1	L/L	L/L
MFLatestSpecificBehaviorSpecific	S/v1	S/v2	S/v2
MFLatestSpecificBehaviorLatest	[error]	L/L	L/L
MFLatestSpecificBehaviorAutomatic	S/v1	L/L	L/L

Description

Gets the path to the file either in the ID view or a traditional folder.

Syntax

Visual Basic
Public Function GetPathInDefaultViewEx( _ ByVal ObjID As ObjID, _ ByVal ObjectVersion As Long, _ ByVal FileID As Long, _ ByVal FileVersion As Long, _ Optional ByVal LatestSpecificBehavior As MFLatestSpecificBehavior = MFLatestSpecificBehaviorAutomatic, _ Optional ByVal PreferTraditionalFolderLocation As Boolean = False, _ Optional ByVal UpdateFromServer As Boolean = False _ ) As String

Visual Basic

Public Function GetPathInDefaultViewEx( _
   ByVal ObjID As ObjID, _
   ByVal ObjectVersion As Long, _
   ByVal FileID As Long, _
   ByVal FileVersion As Long, _
   Optional ByVal LatestSpecificBehavior As MFLatestSpecificBehavior = MFLatestSpecificBehaviorAutomatic, _
   Optional ByVal PreferTraditionalFolderLocation As Boolean = False, _
   Optional ByVal UpdateFromServer As Boolean = False _
) As String

Parameters

ObjID

The ID of the object containing the file.

ObjectVersion

The object version to target. Use "-1" for the latest version.

FileID

The ID of the file.

FileVersion

The file version. Use "-1" for the latest one.

LatestSpecificBehavior

Value	Description
MFLatestSpecificBehaviorAutomatic	Automatically chooses the LatestOnly behavior (L folder) if the object version is the latest version. Otherwise, it chooses the SpecificOnly behavior (S folder). Only one location is ever returned when using this method.
MFLatestSpecificBehaviorLatest	Returns a location in the L (Latest) folder only. (Otherwise the latest version is shown in both the L and S folders.)
MFLatestSpecificBehaviorNormal	Normal behavior can return locations in both the L and S folders.
MFLatestSpecificBehaviorSpecific	Returns a location in the S (Specific) folder only, even if evaluating the latest version.

If the target object exists with versions 1 and 2, the following table summarizes the L or S specific segments of the location path:

Flag value	Requested version 1	Requested version 2	Requested version -1
MFLatestSpecificBehaviorNormal	S/v1	L/L	L/L
MFLatestSpecificBehaviorSpecific	S/v1	S/v2	S/v2
MFLatestSpecificBehaviorLatest	[error]	L/L	L/L
MFLatestSpecificBehaviorAutomatic	S/v1	L/L	L/L

PreferTraditionalFolderLocation

True if the file location should be in a traditional folder (given that there is one).

UpdateFromServer

True if the information should be always updated from the server.

Remarks

This method returns a non-volatile path to the object; the path does not change even if the object properties change. This is the recommended path for opening an object file in an application, or for storing the path.

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