With ValidateMode 'NEVER' (1) the method is never called.
If ValidateMode 'ALWAYS' (2) is configured then the method is called for each client item access request, even if the item exists in the server cache. The access can be denied for a specific client by returning an error code in err[] for such items.
If ValidateMode 'UNKNOWNITEMS' (0) is configured then the method is called when a client requests access to an item that is not yet added to the UA server address space. This method can: - add the item to the server's address space and return success. For each item to be added the callback method 'AddItem' has to be called. - return error for all or some items
Syntax
| Visual Basic (Declaration) | |
|---|---|
Public Delegate Function DlgPlgValidateItems( _ ByVal instanceHandle As Integer, _ ByVal FullItemId() As String, _ ByVal reason As Integer, _ ByRef err As Integer() _ ) As Integer | |
| C# | |
|---|---|
public delegate int DlgPlgValidateItems( int instanceHandle, string[] FullItemId, int reason, out int[] err ) | |
Parameters
- instanceHandle
- Handle the identifies the UA session and thru it the calling client application. The method GetServerInstancesInfo can be used to get name information for this handle.
- FullItemId
- [in] string array with the names of the items to be validated
- reason
- ValidateReason enumerator indicating why the method is called
- err
- HRESULTS array with success/error code for each requested item
Return Value
the number of successfully added items and/or accessible items.Requirements
Target Platforms: Windows 7, Windows Vista SP1 or later, Windows XP SP3, Windows Server 2008 (Server Core not supported), Windows Server 2008 R2 (Server Core supported with SP1 or later), Windows Server 2003 SP2