OpenViewInstance

ACCPAC Common Controls

AccpacDBLink.OpenViewInstance

Opens a view on the current database link, with the optional arguments giving enhanced control over the view's behavior.

Function OpenViewInstance(
ViewID As String,
ppView As AccpacView,
[Readonly As Boolean = False],
[Unvalidated As Boolean = False],
[Unrevisioned As Boolean = False],
[Nonheritable As Boolean = False],
[Prefetch As Long],
[RawPut As Boolean = False],
[Noncascading As Boolean = False],
[extra] As Variant,
[ProcessServer As AccpacProcessServerSetup]) As Long

Parameters

ViewID

[in] the Roto ID of the view to open

ppView

[out] returns the AccpacView object created

Readonly

[in, optional] if set to TRUE, opens the view in Read-only mode

Unvalidated

[in, optional] if set to TRUE, suppresses validation on the view

Unrevisioned

[in, optional] if set to TRUE, revisioning is disabled for the view

Nonheritable

[in, optional] if set to TRUE, composite views will not inherit the flags with which this view was opened

Prefetch

[in, optional] the number of records to pre-fetch when the view instance is read-only

RawPut

[in, optional] if set to TRUE, data will not be processed upon a field Put

Noncascading

[in, optional] if set to TRUE, suppresses propagation of foreign key values to composite views

extra

[in, optional] application-specific data to be passed to the view when it is opened (an unstructured block of data given to the view - the data type and format should be understood by both the caller and the view)

ProcessServer

[in, optional] an AccpacProcessServerSetup object configured with the desired settings; pass Null if Process Server should not be used with the view

Return Value

Returns a status code of the view open operation. If the view is opened successfully, the return value is 0.

Remarks

The AccpacProcessServerSetup object is a hidden member of the ACCPAC COM API library.