DdfTestOwnerName

Applies to:

VAccess

Description

Sets the owner name used for opening dictionary files and determines whether or not a dictionary can be successfully opened and updated using the given owner name.

Syntax

object. DdfTestOwnerName ownerName

The DdfTestOwnerName method syntax has these parts:


Part	Description
object	Required. The name of a valid VAccess control.
ownerName	Required. The new owner name to test for the dictionary. If this is blank, DdfTestOwnerName will use the current dictionary owner name.

Return Value

DdfTestOwnerName returns a two-byte integer that holds the status of the VAccess control. If this is zero, the dictionaries can be opened and updated with the current dictionary owner name.

Remarks

The default dictionary owner name used by the VAccess control will usually open DDF files to reads and updates. However, some dictionary files may have an owner name other than the default. In this case, you may use DdfTestOwnerName to set the dictionary owner name and test it against the current dictionary as specified by DdfPath.

DdfTestOwnerName first tries to open the dictionary. If it is successful, it attempts to update the first record to see whether the owner name allows updates or only allows read attempts. The returned status will indicate whether the owner name can open the file, modify the file, or neither.