uaPLUS Reference
WriteItems(Int32,DeviceItemValue[],Int32[]) Method
See Also  Send Feedback
NSPlugin Namespace > GenericServer Class > WriteItems Method : WriteItems(Int32,DeviceItemValue[],Int32[]) Method

instanceHandle
Handle the identifies the calling client application. The method GetServerInstancesInfo can be used to get name information for this handle.
values
object with handle, value, quality, timestamp
errors
array with HRESULT success/error codes on return.

Glossary Item Box

Called from the DANSrv PROFESSIONAL EDITION ONLY! This method is called when a client executes a 'write' server call. The items specified in the appHandles array need to be written to the device.
The cache update handling depends on the configuration parameter writeCacheUpdateMode For 0 (Generic): The cache is updated in the generic server after returning from the customization WiteItems method. Items with write error are not updated in the cache.
For 1 (Custom): The customization module needs to update the cache by executing the SetItemValue callback method for each written item. The generic server does not update the cache.

Syntax

Visual Basic (Declaration) 
Public Overloads Function WriteItems( _
   ByVal instanceHandle As Integer, _
   ByVal values() As DeviceItemValue, _
   ByRef errors As Integer() _
) As Integer
C# 
public int WriteItems( 
   int instanceHandle,
   DeviceItemValue[] values,
   out int[] errors
)

Parameters

instanceHandle
Handle the identifies the calling client application. The method GetServerInstancesInfo can be used to get name information for this handle.
values
object with handle, value, quality, timestamp
errors
array with HRESULT success/error codes on return.

Return Value

HRESULT success/error code

Requirements

Target Platforms: Windows XP Professional, Windows Server 2003 family, Windows Vista, Windows 7, Windows Server 2008 family

See Also

© 2010-2018 Copyright Advosol Inc. All Rights Reserved.