Class implementing the UaObject interface for the CertificateGroupType. More...

#include <opcua_certificategrouptype.h>

Public Member Functions
	CertificateGroupType (const UaNodeId &nodeId, UaObject pInstanceDeclarationObject, NodeManagerConfig pNodeConfig, UaMutexRefCounted *pSharedMutex=NULL)
	Construction of the class CertificateGroupType. More...

	CertificateGroupType (const UaNodeId &nodeId, const UaString &name, OpcUa_UInt16 browseNameNameSpaceIndex, NodeManagerConfig pNodeConfig, UaMutexRefCounted pSharedMutex=NULL)
	Construction of the class CertificateGroupType. More...

	CertificateGroupType (UaBase::Object pBaseNode, XmlUaNodeFactoryManager pFactory, NodeManagerConfig pNodeConfig, UaMutexRefCounted pSharedMutex=NULL)
	Constructs an instance of the class CertificateGroupType with all components. More...

virtual UaNodeId	typeDefinitionId () const
	Returns the type definition NodeId for the CertificateGroupType.

virtual UaStatus	beginCall (MethodManagerCallback pCallback, const ServiceContext &serviceContext, OpcUa_UInt32 callbackHandle, MethodHandle pMethodHandle, const UaVariantArray &inputArguments)
	Call method of an UA object. More...

virtual UaStatus	call (const ServiceContext &serviceContext, MethodHandle *pMethodHandle, const UaVariantArray &inputArguments, UaVariantArray &outputArguments, UaStatusCodeArray &inputArgumentResults, UaDiagnosticInfos &inputArgumentDiag)
	Synchronous version of the MethodManager method call executed in a worker thread.

virtual UaStatus	GetRejectedList (const ServiceContext &serviceContext, UaByteStringArray &Certificates)
	Returns the list of Certificates that have been rejected by the Server for the related trust list. More...

virtual void	setCertificateTypes (const UaNodeIdArray &CertificateTypes)
	Sets the CertificateTypes. More...

virtual void	getCertificateTypes (UaNodeIdArray &CertificateTypes) const
	Gets the CertificateTypes. More...

virtual OpcUa::CertificateExpirationAlarmType *	getCertificateExpired ()
	Returns the CertificateExpired node. More...

virtual const OpcUa::CertificateExpirationAlarmType *	getCertificateExpired () const
	Returns the CertificateExpired node. More...

virtual OpcUa::TrustListOutOfDateAlarmType *	getTrustListOutOfDate ()
	Returns the TrustListOutOfDate node. More...

virtual const OpcUa::TrustListOutOfDateAlarmType *	getTrustListOutOfDate () const
	Returns the TrustListOutOfDate node. More...

virtual OpcUa::PropertyType *	getCertificateTypesNode ()
	Returns the CertificateTypes node. More...

virtual const OpcUa::PropertyType *	getCertificateTypesNode () const
	Returns the CertificateTypes node. More...

virtual OpcUa::TrustListType *	getTrustList ()
	Returns the TrustList node. More...

virtual const OpcUa::TrustListType *	getTrustList () const
	Returns the TrustList node. More...

virtual OpcUa::BaseMethod *	getGetRejectedList ()
	Returns the GetRejectedList node. More...

virtual const OpcUa::BaseMethod *	getGetRejectedList () const
	Returns the GetRejectedList node. More...

virtual void	useAccessInfoFromType ()
	Applies the NodeAccessInfo set at the CertificateGroupTypeBase and its children. More...

void	useAccessInfoFromInstance (CertificateGroupType *pInstance)
	Uses the NodeAccessInfo of pOther and its children. More...

Public Member Functions inherited from OpcUa::BaseObjectType
	BaseObjectType (const UaNodeId &nodeId, UaObject pInstanceDeclarationObject, NodeManagerConfig pNodeConfig, UaMutexRefCounted *pSharedMutex=NULL)
	Construction of the class BaseObjectType. More...

	BaseObjectType (const UaNodeId &nodeId, const UaString &name, OpcUa_UInt16 browseNameNameSpaceIndex, NodeManagerConfig pNodeConfig, UaMutexRefCounted pSharedMutex=NULL)
	Construction of the class BaseObjectType. More...

UaReferenceLists *	getUaReferenceLists () const
	Get the UaReferenceLists interface for the node. More...

virtual UaStatus	browse (const ServiceContext &serviceContext, BrowseContext &browseContext, UaReferenceDescriptions &References)
	Discover the references of a specified node of a view. More...

UaNodeId	nodeId () const
	Get the NodeId of the current Node. More...

virtual UaQualifiedName	browseName () const
	Get the browseName of the current Node. More...

virtual UaLocalizedText	displayName (Session *pSession) const
	Get the displayName as LocalizedText of the current Node. More...

virtual OpcUa_Boolean	isDescriptionSupported () const
	Check if Node is DescriptionSupported. More...

virtual UaLocalizedText	description (Session *pSession) const
	Get the description as LocalizedText of the current Node. More...

virtual OpcUa_Boolean	isWriteMaskSupported () const
	Check if Node is WriteMaskSupported. More...

virtual OpcUa_UInt32	writeMask () const
	Get the writeMask of the current Node. More...

virtual OpcUa_Boolean	isUserWriteMaskSupported () const
	Check if Node is UserWriteMaskSupported. More...

virtual OpcUa_UInt32	userWriteMask (Session *pSession) const
	Check if Node has a userWriteMask. More...

UaNode *	getUaNode () const
	Get the UaNode interface pointer of this node. More...

virtual OpcUa_Byte	eventNotifier () const
	Returns the EventNotifier for the BaseObjectType. More...

virtual MethodManager *	getMethodManager (UaMethod *pMethod) const
	Returns the method manager interface for the BaseObjectType instance. More...

virtual void	setUserData (UserDataBase *pUserData)
	Method to set user data stored in this class. More...

virtual UserDataBase *	getUserData () const
	Method to get the user data stored in this class. More...

virtual void	setBrowseName (const UaQualifiedName &browseName)
	Sets the browse name attribute value. More...

virtual void	setDisplayName (const UaLocalizedText &displayName)
	Sets the display name attribute value. More...

virtual void	setDescription (const UaLocalizedText &description)
	Sets the description attribute value. More...

virtual void	setWriteMask (OpcUa_UInt32 writeMask)
	Sets the write mask attribute value. More...

virtual void	setEventNotifier (OpcUa_Byte eventNotifier)
	Sets the eventNotifier attribute value. More...

virtual void	setModellingRuleId (const UaNodeId &modellingRuleId)
	Set NodeId of the modeling rule for this node. More...

virtual UaNodeId	modellingRuleId () const
	Get NodeId of the modeling rule for this node. More...

void	setMethodManager (MethodManager *pMethodManager)
	Allows a class aggregating the object to implement the MethodManager for this object. More...

virtual UaStatus	setAttributeValue (Session pSession, OpcUa_Int32 attributeId, const UaDataValue &dataValue, NodeAccessInfo pDefaultPermissions, OpcUa_Boolean checkWriteMask)
	Sets the value of an attribute of the Node. More...

Public Member Functions inherited from MethodManager
	MethodManager ()
	construction

virtual	~MethodManager ()
	destruction

Public Member Functions inherited from UaObject
	UaObject (UaMutexRefCounted *pSharedMutex=NULL)
	Construction of the UaObject. More...

OpcUa_NodeClass	nodeClass () const
	Get the node class of the Node. More...

virtual void	getAttributeValue (Session pSession, OpcUa_Int32 attributeId, NodeAccessInfo pDefaultPermissions, UaDataValue &uaDataValue)
	Gets the value of an attribute of the Node. More...

Public Member Functions inherited from UaNode
	UaNode (UaMutexRefCounted *pSharedMutex=NULL)
	Construction of the UaNode. More...

virtual UaNodeId	getKey () const
	Get the key of the node used for the hash table. More...

virtual NodeAccessInfo *	getAccessInfo () const
	Returns the access info for this node. More...

virtual bool	hasAccessInfo () const
	Check if this UaNode has a NodeAccessInfo assigned. More...

virtual void	useAccessInfoFrom (const UaNode *pOther)
	Set the NodeAccessInfo from another node to this node. More...

virtual void	setAccessInfo (NodeAccessInfo *pAccessInfo)
	Set the NodeAccessInfo for this node. More...

virtual void	attachAccessInfo (NodeAccessInfo *pAccessInfo)
	Set the NodeAccessInfo for this node. More...

Public Member Functions inherited from ChainEntry
	ChainEntry ()
	construction

ChainEntry *	find (const UaNodeId &key, ChainEntry **ppPrevious)
	finds the right entry in the chain. More...

void	add (ChainEntry *pNewEntry)
	adds a new entry to the list. More...

void	prepend (ChainEntry *pNewEntry)
	prepends a new entry to the list. More...

ChainEntry *	remove (const UaNodeId &key, ChainEntry **ppNext)
	removes an entry from the list. More...

ChainEntry *	getNext () const
	Check if there is a chain. More...

virtual void	setInvalid ()
	Set the entry to invalid. More...

void	clearChain ()
	Clear the chain when the hashtable is cleared.

Public Member Functions inherited from ReferenceCounter
	ReferenceCounter ()
	construction

virtual	~ReferenceCounter ()
	destruction

Public Member Functions inherited from UaReferenceLists
	UaReferenceLists ()
	Constructs the reference lists object.

virtual	~UaReferenceLists ()
	Destroys the reference lists object.

virtual UaStatus	browseReferences (const ServiceContext &serviceContext, BrowseContext &browseContext, UaReferenceDescriptions &References)
	Discover the references of a specified node of a view. More...

virtual UaStatus	translateBrowsePathToNodeId (const ServiceContext &serviceContext, const UaNodeId &startingNode, UaRelativePath &relativePath, UaBrowsePathTargets &browsePathTargets)
	Find a node based on an element of an relative path. More...

virtual const UaReference *	pTargetNodes () const
	Returns the list of references to target nodes. More...

virtual const UaReference *	pSourceNodes () const
	Returns the list of references to source nodes. More...

virtual UaNode *	getTargetNodeByBrowseName (const UaQualifiedName &browseName) const
	Searches a target node with the passed browse name and returns the UaNode interface if found. More...

virtual void	addTargetNode (UaReference *pReference)
	Add a reference to a target node where this node is the source node. More...

virtual void	addSourceNode (UaReference *pReference)
	Adds a reference to a source node where this node is the target node. More...

virtual UaStatus	removeSourceNode (UaReference *pReferenceToRemove)
	Remove a reference to a source node where this node is the target node. More...

virtual bool	removeSourceReference (UaReference *pReferenceToRemove)
	Remove the passed reference to a source node. More...

virtual UaStatus	removeTargetNode (UaNode *pTargetNode, const UaNodeId &referenceTypeId, OpcUa_Boolean deleteBidirectional)
	Remove a reference to a target node where this node is the source node. More...

virtual UaStatus	removeTargetNode (const UaNodeId &targetNodeId, const UaNodeId &referenceTypeId, OpcUa_Boolean deleteBidirectional)
	Remove a reference to a target node where this node is the source node. More...

virtual bool	removeTargetReference (UaReference *pReferenceToRemove)
	Remove the passed reference to a target node. More...

virtual UaStatus	removeCrossNodeManagerRef (NodeManager *pNodeManager)
	Remove references to another NodeManager. More...

virtual UaStatus	invalidateSourceReferences (OpcUa_Boolean deleteSourceReferences)
	Set all references from SourceNodes to this Node invalid. More...

virtual UaStatus	invalidateTargetReferences (OpcUa_Boolean deleteTargetReferences)
	Set all references to TargetNode of this node invalid. More...

virtual UaStatus	deleteAllChildren (NodeManagerConfig *pNodeManagerConfig)
	Deletes all child nodes. More...

Static Public Member Functions
static void	createTypes ()
	Create the related type nodes.

static void	clearStaticMembers ()
	Clear the static members of the class.

Static Public Member Functions inherited from OpcUa::BaseObjectType
static void	clearStaticMembers ()
	Clear the static members of the class.

Protected Member Functions
virtual	~CertificateGroupType ()
	Destruction.

Protected Member Functions inherited from OpcUa::BaseObjectType
virtual	~BaseObjectType ()
	Destruction of the BaseObjectType. More...

Protected Member Functions inherited from UaObject
virtual	~UaObject ()
	Destruction of the UaObject. More...

Protected Member Functions inherited from UaNode
virtual	~UaNode ()
	Destruction of the UaNode. More...

Protected Member Functions inherited from ChainEntry
virtual	~ChainEntry ()
	destruction

Protected Member Functions inherited from UaReferenceLists
virtual UaStatus	collectAllChildrenRecursive (NodeManagerConfig *pNodeManagerConfig, NodesToDeleteCollection &nodesToDeleteCollection, int recursionCounter=0)
	Collect a list of all child nodes. More...

Additional Inherited Members
Protected Attributes inherited from UaReferenceLists
UaReference *	m_pTargetNodes
	List of references to target nodes where this node is the source node. More...

UaReference *	m_pLastTargetNode
	Last references in the list of references to the target nodes. More...

UaReference *	m_pSourceNodes
	List of references to source nodes where this node is the target node. More...

Detailed Description

Class implementing the UaObject interface for the CertificateGroupType.

OPC UA Objects are used to represent systems, system components, real-world objects and software objects. They have the NodeClass Object. The detailed description of Objects and their attributes can be found in the general description of the Object node class.

Object members of the CertificateGroupType:

Browse Name	TypeDefinition	Modelling Rule	See Also
CertificateExpired	CertificateExpirationAlarmType	Optional	getCertificateExpired
TrustList	TrustListType	Mandatory	getTrustList
TrustListOutOfDate	TrustListOutOfDateAlarmType	Optional	getTrustListOutOfDate

Variable members of the CertificateGroupType:

Browse Name	DataType	TypeDefinition	Modelling Rule	See Also
CertificateTypes	NodeId	PropertyType	Mandatory	getCertificateTypes, setCertificateTypes

A type used for objects which represent certificate groups in the address space.

A certificate group is a context that contains a trust list and one or more certificate s that can be assigned to an application. This type exists to allow an application which has multiple trust lists and/or application certificate s to express them in its AddressSpace.

The TrustList object is the trust list associated with the certificate group.

See also CertificateGroupType for a documentation of the complete Information Model.

Constructor & Destructor Documentation

OpcUa::CertificateGroupType::CertificateGroupType	(	const UaNodeId &	nodeId,
		UaObject *	pInstanceDeclarationObject,
		NodeManagerConfig *	pNodeConfig,
		UaMutexRefCounted *	pSharedMutex = `NULL`
	)

Construction of the class CertificateGroupType.

This constructor is used if the object is created based on an instance declaration of an object type. Since the only difference between the instance declaration object and the instance object are the node id, the pointer to the instance declaration node is used to get the attribute values other than NodeId from the instance declaration node.

The object is reference counted and can not be deleted directly. The reference counter is set to one after the object is created. If the object was successfully added to a NodeManager using the methods NodeManagerConfig::addUaNode or NodeManagerConfig::addNodeAndReference the NodeManager will release this reference during shut down. If the object was not added to a NodeManager, it must be deleted using the releaseReference method. If the interface pointer is used in other places, the availability of the object must be ensured by incrementing the reference counter with addReference when the pointer is stored somewhere and decremented with releaseReference if the interface pointer is not longer needed.

Parameters

[in]	nodeId	NodeId of the new object
[in]	pInstanceDeclarationObject	UaObject interface of the instance declaration node used to provide attribute values other than NodeId
[in]	pNodeConfig	Interface pointer to the NodeManagerConfig interface used to add and delete node and references in the address space
[in]	pSharedMutex	Shared mutex object used to synchronize access to the object. Can be NULL if no shared mutex is provided

OpcUa::CertificateGroupType::CertificateGroupType	(	const UaNodeId &	nodeId,
		const UaString &	name,
		OpcUa_UInt16	browseNameNameSpaceIndex,
		NodeManagerConfig *	pNodeConfig,
		UaMutexRefCounted *	pSharedMutex = `NULL`
	)

Construction of the class CertificateGroupType.

This constructor is used if the object is not created based on an instance declaration. It defines the name and node id of the object. Additional language specific names and other attribute values can be set with set methods provided by the class.

The object is reference counted and can not be deleted directly. The reference counter is set to one after the object is created. If the object was successfully added to a NodeManager using the methods NodeManagerConfig::addUaNode or NodeManagerConfig::addNodeAndReference the NodeManager will release this reference during shut down. If the object was not added to a NodeManager, it must be deleted using the releaseReference method. If the interface pointer is used in other places, the availability of the object must be ensured by incrementing the reference counter with addReference when the pointer is stored somewhere and decremented with releaseReference if the interface pointer is not longer needed.

Parameters

[in]	nodeId	NodeId of the new object
[in]	name	Name of the new object. Used as browse name and also as display name if no additional language specific names are set.
[in]	browseNameNameSpaceIndex	Namespace index used for the browse name
[in]	pNodeConfig	Interface pointer to the NodeManagerConfig interface used to add and delete node and references in the address space
[in]	pSharedMutex	Shared mutex object used to synchronize access to the object. Can be NULL if no shared mutex is provided

OpcUa::CertificateGroupType::CertificateGroupType	(	UaBase::Object *	pBaseNode,
		XmlUaNodeFactoryManager *	pFactory,
		NodeManagerConfig *	pNodeConfig,
		UaMutexRefCounted *	pSharedMutex = `NULL`
	)

Constructs an instance of the class CertificateGroupType with all components.

Parameters

[in]	pBaseNode	The "tree" of nodes that specifies the attributes of the instance and its children
[in]	pFactory	The factory to create the children
[in]	pNodeConfig	Interface pointer to the NodeManagerConfig interface used to add and delete node and references in the address space
[in]	pSharedMutex	Shared mutex object used to synchronize access to the variable. Can be NULL if no shared mutex is provided

Member Function Documentation

UaStatus OpcUa::CertificateGroupType::beginCall	(	MethodManagerCallback *	pCallback,
		const ServiceContext &	serviceContext,
		OpcUa_UInt32	callbackHandle,
		MethodHandle *	pMethodHandle,
		const UaVariantArray &	inputArguments
	)

virtual

Call method of an UA object.

Implementation of the MethodManager interface method beginCall.

Reimplemented from OpcUa::BaseObjectType.

OpcUa::CertificateExpirationAlarmType * OpcUa::CertificateGroupType::getCertificateExpired ( )

virtual

Returns the CertificateExpired node.

If the Object has not been created yet, this method creates the node and returns it.

const OpcUa::CertificateExpirationAlarmType * OpcUa::CertificateGroupType::getCertificateExpired ( ) const

virtual

Returns the CertificateExpired node.

If the Object has not been created yet, this method return NULL.

void OpcUa::CertificateGroupType::getCertificateTypes ( UaNodeIdArray & CertificateTypes ) const

virtual

Gets the CertificateTypes.

Specifies the NodeIds of the CertificateTypes which may be assigned to applications which belong to the certificate group.

For example, a certificate group with the NodeId of RsaMinApplicationCertificateType and the NodeId RsaSha256ApplicationCertificate specified allows an application to have one ApplicationInstance certificate for each type. Abstract base types may be used in this value and indicate that any subtype is allowed. If this list is empty, the certificate group does not allow certificate s to be assigned to applications (i.e. the Certificate Group exists to allow the associated trust list to be read or updated). All CertificateTypes for a given certificate group shall be subtypes of a single common type which shall be either ApplicationCertificateType or HttpsCertificateType.

OpcUa::PropertyType * OpcUa::CertificateGroupType::getCertificateTypesNode ( )

virtual

Returns the CertificateTypes node.

Specifies the NodeIds of the CertificateTypes which may be assigned to applications which belong to the certificate group.

For example, a certificate group with the NodeId of RsaMinApplicationCertificateType and the NodeId RsaSha256ApplicationCertificate specified allows an application to have one ApplicationInstance certificate for each type. Abstract base types may be used in this value and indicate that any subtype is allowed. If this list is empty, the certificate group does not allow certificate s to be assigned to applications (i.e. the Certificate Group exists to allow the associated trust list to be read or updated). All CertificateTypes for a given certificate group shall be subtypes of a single common type which shall be either ApplicationCertificateType or HttpsCertificateType.

const OpcUa::PropertyType * OpcUa::CertificateGroupType::getCertificateTypesNode ( ) const

virtual

Returns the CertificateTypes node.

Specifies the NodeIds of the CertificateTypes which may be assigned to applications which belong to the certificate group.

For example, a certificate group with the NodeId of RsaMinApplicationCertificateType and the NodeId RsaSha256ApplicationCertificate specified allows an application to have one ApplicationInstance certificate for each type. Abstract base types may be used in this value and indicate that any subtype is allowed. If this list is empty, the certificate group does not allow certificate s to be assigned to applications (i.e. the Certificate Group exists to allow the associated trust list to be read or updated). All CertificateTypes for a given certificate group shall be subtypes of a single common type which shall be either ApplicationCertificateType or HttpsCertificateType.

OpcUa::BaseMethod * OpcUa::CertificateGroupType::getGetRejectedList ( )

virtual

Returns the GetRejectedList node.

If the GetRejectedList node has not been created yet, this method creates the node and returns it.

const OpcUa::BaseMethod * OpcUa::CertificateGroupType::getGetRejectedList ( ) const

virtual

Returns the GetRejectedList node.

If the GetRejectedList node has not been created yet, this method returns NULL.

UaStatus OpcUa::CertificateGroupType::GetRejectedList	(	const ServiceContext &	serviceContext,
		UaByteStringArray &	Certificates
	)

virtual

Returns the list of Certificates that have been rejected by the Server for the related trust list.

No rules are defined for how the Server updates this list or how long a certificate is kept in the list. It is recommended that every valid but untrusted certificate be added to the rejected list as long as storage is available. Servers should omit older entries from the list returned if the maximum message size is not large enough to allow the entire list to be returned.

This method requires an encrypted channel and that the Client provides credentials with administrative rights on the Server.

Method Result Codes

Result Code	Description
Bad_UserAccessDenied	The current user does not have the rights required.

Parameters

	serviceContext	General context for the service calls containing information like the session object, return diagnostic mask and timeout hint.
[out]	Certificates	The DER encoded form of the Certificates rejected by the Server.

OpcUa::TrustListType * OpcUa::CertificateGroupType::getTrustList ( )

virtual

Returns the TrustList node.

The trust list associated with the certificate group.

const OpcUa::TrustListType * OpcUa::CertificateGroupType::getTrustList ( ) const

virtual

Returns the TrustList node.

The trust list associated with the certificate group.

OpcUa::TrustListOutOfDateAlarmType * OpcUa::CertificateGroupType::getTrustListOutOfDate ( )

virtual

Returns the TrustListOutOfDate node.

If the Object has not been created yet, this method creates the node and returns it.

const OpcUa::TrustListOutOfDateAlarmType * OpcUa::CertificateGroupType::getTrustListOutOfDate ( ) const

virtual

Returns the TrustListOutOfDate node.

If the Object has not been created yet, this method return NULL.

void OpcUa::CertificateGroupType::setCertificateTypes ( const UaNodeIdArray & CertificateTypes )

virtual

Sets the CertificateTypes.

Specifies the NodeIds of the CertificateTypes which may be assigned to applications which belong to the certificate group.

For example, a certificate group with the NodeId of RsaMinApplicationCertificateType and the NodeId RsaSha256ApplicationCertificate specified allows an application to have one ApplicationInstance certificate for each type. Abstract base types may be used in this value and indicate that any subtype is allowed. If this list is empty, the certificate group does not allow certificate s to be assigned to applications (i.e. the Certificate Group exists to allow the associated trust list to be read or updated). All CertificateTypes for a given certificate group shall be subtypes of a single common type which shall be either ApplicationCertificateType or HttpsCertificateType.

void OpcUa::CertificateGroupType::useAccessInfoFromInstance ( CertificateGroupType * pOther )

Uses the NodeAccessInfo of pOther and its children.

void OpcUa::CertificateGroupType::useAccessInfoFromType ( )

virtual

Applies the NodeAccessInfo set at the CertificateGroupTypeBase and its children.

Reimplemented from OpcUa::BaseObjectType.

The documentation for this class was generated from the following files:

C:/work/uasdkcpp/src/uaserver/uaservercpp/coremodule/opcua_certificategrouptype.h
C:/work/uasdkcpp/src/uaserver/uaservercpp/coremodule/opcua_certificategrouptype.cpp

Public Member Functions

Static Public Member Functions

Protected Member Functions

Additional Inherited Members

Detailed Description

Constructor & Destructor Documentation

Member Function Documentation