DANSrvAE Reference
WriteItems(Int32,DeviceItemValue[],Int32[]) Method
See Also  Send comments on this topic.
NSPlugin Assembly > 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 writeCacheUpdateMode selection set in the GetModeDefinitions() implementation. 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

Platforms: Windows 98, Windows NT 4.0, Windows Millennium Edition, Windows 2000, Windows XP Home Edition, Windows XP Professional, Windows Server 2003 family

See Also

© 2004-2017 Advosol Inc. All Rights Reserved.