OPC UA API reference
303 symbols
PDCOMM_OPCUA_AES128SHA256RSAOAEPhttp://opcfoundation.org/UA/SecurityPolicy#Aes128_Sha256_RsaOaep.PDCOMM_OPCUA_AES256SHA256RSAPSShttp://opcfoundation.org/UA/SecurityPolicy#Aes256_Sha256_RsaPss (default).PDCOMM_OPCUA_ALLOW_NONEAllows SecurityPolicy None. Without it the client rejects #PDCOMM_OPCUA_POLICY_NONE and the server advertises secure endpoints only.PDCOMM_OPCUA_BASIC256SHA256http://opcfoundation.org/UA/SecurityPolicy#Basic256Sha256.PDCOMM_OPCUA_BUFFER_TOO_SMALLThe output is too small; the required size is reported and the output is unchanged.PDCOMM_OPCUA_BUSYThe handle is in use by another thread, requests are outstanding, or a response is held for pdcomm_opcua_client_take_response().PDCOMM_OPCUA_CLOSEDThe client or server is closed or has failed; release it.PDCOMM_OPCUA_EMPTYThe requested response has not arrived yet; poll and try again.PDCOMM_OPCUA_INTERNAL_ERRORAn internal failure, such as a contained panic; see pdcomm_opcua_last_error_copy().PDCOMM_OPCUA_INVALID_HANDLEThe handle is zero, released, unknown or of the wrong kind.PDCOMM_OPCUA_INVALID_INPUTAn argument, size, structure version or encoding is invalid, or a request ID is unknown.PDCOMM_OPCUA_LICENSE_REQUIREDNo valid PDComm license grants the module this call needs (opcua-client or opcua-server), so nothing was started. The detail text names the module and the license state, such as missing, expired or updates-expired. Added in ABI 0.2.PDCOMM_OPCUA_LIMITA resource limit was reached; the request was not sent or the handle was not created.PDCOMM_OPCUA_MODE_NONENone: only valid with #PDCOMM_OPCUA_POLICY_NONE.PDCOMM_OPCUA_OKThe call succeeded.PDCOMM_OPCUA_POISONEDA previous call panicked; the handle is invalid and may only be released.PDCOMM_OPCUA_POLICY_NONEhttp://opcfoundation.org/UA/SecurityPolicy#None: no signing or encryption. Requires #PDCOMM_OPCUA_MODE_NONE and #PDCOMM_OPCUA_ALLOW_NONE.PDCOMM_OPCUA_RUNTIME_ERRORA network, security, protocol or address-space failure, including a timeout or an invalid response. The detail text names the cause.PDCOMM_OPCUA_SIGNSign: messages are signed but not encrypted.PDCOMM_OPCUA_SIGN_AND_ENCRYPTSignAndEncrypt: messages are signed and encrypted (default).PDCOMM_OPCUA_USER_SECRET_HEADER_POLICY_ONLYClient only: for user secrets longer than 64 bytes, which are sent as an RSA EncryptedSecret, leave the token's encryptionAlgorithm empty so that the SecurityPolicy in the secret's header alone selects the algorithms. Set it only when the server expects this form. Shorter secrets use the legacy encrypted token and always carry the algorithm URI.PDCOMM_OPCUA_VARIABLE_PUBLICAnonymous sessions may access the variable. Without this flag only authenticated users may read or write it, and anonymous sessions get BadUserAccessDenied.PDCOMM_OPCUA_VARIABLE_WRITABLEClients may write the Value attribute (AccessLevel CurrentWrite).pdcomm_opcua_abi_versionReturns the ABI version of the loaded library.pdcomm_opcua_buffer_copyCopies the bytes of a buffer handle.pdcomm_opcua_bytesA borrowed byte range: UTF-8 text or binary data without a terminator.dataFirst byte of the range, or null for an empty range.sizeNumber of bytes in the range.pdcomm_opcua_client_activate_anonymousActivates the session with an AnonymousIdentityToken (ActivateSession).pdcomm_opcua_client_activate_user_nameActivates the session with a UserNameIdentityToken (ActivateSession).pdcomm_opcua_client_beginQueues one UA Binary service request without waiting for its response.pdcomm_opcua_client_closeCloses the session and the secure channel in an orderly way.pdcomm_opcua_client_connectConnects a client and creates a session.pdcomm_opcua_client_optionsClient connection options (structure version 1).application_uriApplicationUri, at most 4096 bytes; empty means urn:pdcomm:opcua:client.certificate_derClient application instance certificate (DER, at most 64 KiB); required unless the policy is None.flagsBitwise OR of ::pdcomm_opcua_option_flags values.modeRequested ::pdcomm_opcua_security_mode value.policyRequested ::pdcomm_opcua_policy value.private_key_pemPrivate key of that certificate (PEM, at most 64 KiB).struct_sizeSize of this structure in bytes as known by the caller.timeout_msTimeout of each network exchange and of each outstanding request, 1 to 300000 ms.trusted_server_derServer certificate to trust (DER, at most 64 KiB); the only trust anchor of this client.versionStructure version; must be 1.pdcomm_opcua_client_options_initFills client options with the defaults.pdcomm_opcua_client_pollPerforms one non-blocking I/O pass: sends queued bytes and receives arrived responses.pdcomm_opcua_client_take_responseTakes the validated response of one request.pdcomm_opcua_discoverReads the endpoints of a server (GetEndpoints).pdcomm_opcua_handleOpaque, library-local handle of a client, a server or a buffer.pdcomm_opcua_last_error_copyCopies the detail text of the last failed call on this thread.pdcomm_opcua_license_host_idCopies the host id of this machine, PDH1-XXXX-XXXX-XXXX-XXXX.pdcomm_opcua_license_installInstalls PDComm license text for this library.pdcomm_opcua_license_statusCopies the license status of this library as UTF-8 JSON.pdcomm_opcua_option_flagsBits of the flags member of the client and server options.pdcomm_opcua_policySecurityPolicy of the secure channel that the client requests.pdcomm_opcua_releaseReleases a client, server or buffer handle.pdcomm_opcua_response_get_infoReads the metadata of a response buffer.pdcomm_opcua_response_infoMetadata of a validated service response (structure version 1).binary_idNumeric namespace 0 encoding ID of the body, such as 634 for ReadResponse or 397 for ServiceFault.request_idID that pdcomm_opcua_client_begin() returned; equals the ResponseHeader requestHandle.reservedWritten as zero.service_statusResponseHeader serviceResult; Bad only for a ServiceFault.struct_sizeIn: size known by the caller.versionIn and out: structure version 1.pdcomm_opcua_security_modeMessageSecurityMode of the secure channel, with the numeric values of the Part 4 MessageSecurityMode enumeration.pdcomm_opcua_server_add_variableAdds a Variable node below the Objects folder.pdcomm_opcua_server_closeStops the server: closes the listener and aborts every channel.pdcomm_opcua_server_createCreates and binds an in-memory OPC UA server.pdcomm_opcua_server_local_addressReturns the socket address the server listens on.pdcomm_opcua_server_optionsServer options of the in-memory server facade (structure version 1).application_uriApplicationUri, at most 4096 bytes; empty means urn:pdcomm:opcua:server.certificate_derServer application instance certificate (DER, at most 64 KiB); required unless #PDCOMM_OPCUA_ALLOW_NONE is set.endpointEndpoint URL advertised to clients (opc.tcp://host:port/path, at most 4096 bytes); port 0 is replaced by the actual listening port.flags0 or #PDCOMM_OPCUA_ALLOW_NONE.max_connectionsConcurrent secure channels: more than max_sessions and at most 1024 (default 33).max_sessionsConcurrent sessions, 1 to 1023 (default 32).private_key_pemPrivate key of that certificate (PEM, at most 64 KiB).reservedMust be zero.struct_sizeSize of this structure in bytes as known by the caller.trusted_client_derThe one client certificate this server trusts (DER, at most 64 KiB).versionStructure version; must be 1.pdcomm_opcua_server_options_initFills server options with the defaults.pdcomm_opcua_server_pollPerforms one non-blocking server pass: accepts connections and processes received requests and subscriptions.pdcomm_opcua_server_read_valueReads the Value attribute of a node as a local, authenticated user.pdcomm_opcua_server_set_valueWrites the Value attribute of a variable as a local, authenticated user.pdcomm_opcua_statusStatus code returned by every int32_t OPC UA C ABI function.pdcomm_opcua_variable_flagsFlags of pdcomm_opcua_server_add_variable().opcuaOPC UA C++ API: RAII wrappers of the C ABI, plus the QtCore and MFC client workers.MfcClientConfigurationConnection and identity settings of an MfcClientWorker.MfcClientConfiguration::anonymousActivate anonymously instead of with userName and userSecret.MfcClientConfiguration::applicationUriApplicationUri in UTF-8, at most 4096 bytes; must match the client certificate.MfcClientConfiguration::certificateDerClient application instance certificate (DER, at most 64 KiB).MfcClientConfiguration::endpointopc.tcp:// endpoint URL in UTF-8, at most 4096 bytes.MfcClientConfiguration::flagsBitwise OR of ::pdcomm_opcua_option_flags values.MfcClientConfiguration::modeRequested ::pdcomm_opcua_security_mode value.MfcClientConfiguration::policyRequested ::pdcomm_opcua_policy value.MfcClientConfiguration::privateKeyPemPrivate key of that certificate (PEM, at most 64 KiB).MfcClientConfiguration::timeoutMsTimeout of each network exchange and each outstanding request, 1 to 300000 ms.MfcClientConfiguration::trustedServerDerServer certificate to trust (DER, at most 64 KiB).MfcClientConfiguration::userNameUTF-8 user name for a UserNameIdentityToken, at most 4096 bytes; used when anonymous is false.MfcClientConfiguration::userSecretUTF-8 password, at most 16 KiB; used when anonymous is false.MfcClientEventOne event taken from the worker's mailbox with MfcClientWorker::Drain().MfcClientEvent::abortedStopped: the worker ended any other way; always !orderly.MfcClientEvent::acceptedStopped: requests admitted by Submit().MfcClientEvent::completedStopped: requests that ended with a response or a begin or response failure.MfcClientEvent::correlationPending, Completed, Failed: correlation passed to MfcClientWorker::Submit(); 0 for a worker failure.MfcClientEvent::discardedStopped: requests that ended with an abort failure.MfcClientEvent::kindEvent kind.MfcClientEvent::metadataCompleted: request ID, encoding ID and serviceResult of the response.MfcClientEvent::orderlyStopped: a drain finished with CloseSession and channel close.MfcClientEvent::ownerThreadReady: Win32 thread ID of the worker thread that owns the native client.MfcClientEvent::phaseFailed: begin, response, abort or worker.MfcClientEvent::reasonStopped: drained-and-closed, aborted, native-error or adapter-error.MfcClientEvent::requestIdPending, Completed: native request ID (the requestHandle).MfcClientEvent::statusFailed: ::pdcomm_opcua_status value of the failure.MfcClientEvent::textFailed: English detail text, copied in the worker thread right after the native call.MfcClientEvent::valueCompleted: the owned response, possibly a ServiceFault. It survives the client and the worker and holds a native handle until the last reference is gone.MfcClientEventKindKind of an MfcClientEvent; it selects which members are set.MfcClientEventKind::CompletedA validated response arrived; correlation, requestId, metadata and value are set.MfcClientEventKind::FailedA request or the worker failed; correlation (0 for the worker), status, phase and text are set.MfcClientEventKind::PendingA request was sent; correlation and requestId are set.MfcClientEventKind::ReadyThe session is activated; ownerThread is set.MfcClientEventKind::StoppedThe worker has ended; always the last event. orderly, aborted, the counters and reason are set.MfcClientStopHow MfcClientWorker::RequestStop() ends the worker.MfcClientStop::AbortStop at the next check, discard pending work and release the client without a protocol close.MfcClientStop::DrainComplete every admitted request, then close the session and channel.MfcClientWorkerOne-shot MFC worker thread that owns a native OPC UA client.MfcClientWorker::DrainTakes every queued event in order; call it on the receiver thread.MfcClientWorker::MaximumCommandsMaximum number of admitted requests that are queued or in flight.MfcClientWorker::MaximumEventsUpper bound of the events that can wait in the mailbox at once.MfcClientWorker::MaximumQueuedBytesMaximum size of one request and of all queued, unsent requests together (4 MiB).MfcClientWorker::MfcClientWorkerCreates a worker; Start() begins the connection.MfcClientWorker::MfcClientWorkerCopying is disabled.MfcClientWorker::RequestStopAsks the worker to stop; thread-safe.MfcClientWorker::StartStarts the worker thread; one-shot.MfcClientWorker::SubmitQueues one UA Binary service request; thread-safe.MfcClientWorker::WaitWaits for the worker thread to exit; owner thread only.MfcClientWorker::operator=Copy assignment is disabled.MfcClientWorker::~MfcClientWorkerRequests an abort, waits for the thread and wipes the credentials.bufferOwned, immutable byte buffer returned by the library.buffer::bufferTakes ownership of a buffer handle.buffer::copyCopies the buffer contents.bytesBorrows the bytes of a string as a ::pdcomm_opcua_bytes view.bytesBorrows the bytes of a vector as a ::pdcomm_opcua_bytes view.checkThrows for a failed C ABI status.clientOPC UA client session over one secure channel.client::activate_anonymousActivates the session anonymously (ActivateSession).client::activate_user_nameActivates the session with a user name and password (ActivateSession).client::beginQueues one UA Binary service request.client::closeCloses the session and the secure channel in an orderly way.client::connectConnects to a server and creates a session.client::discoverReads the endpoints of a server without authentication.client::pollSends queued bytes and receives arrived responses without blocking.client::takeTakes the response of a request if it has arrived.errorException thrown by the wrapper for every failed C ABI call.error::errorCreates an exception.error::license_requiredTells whether the call was refused for lack of a PDComm license.error::statusReturns the status of the failed call.licensePDComm license of the OPC UA library: install license text, read the license status and this host id.license::host_idReturns this host id, PDH1-XXXX-XXXX-XXXX-XXXX.license::installInstalls license text, replacing text installed earlier.license::statusReturns the license status JSON (see pdcomm_opcua_license_status()).optionsReturns client options filled with the library defaults.ownedMove-only owner of one ::pdcomm_opcua_handle; base of every wrapper.owned::operator=Copy assignment is disabled: a handle has exactly one owner.owned::operator=Releases the current handle, then takes ownership from other.owned::ownedCreates an empty owner.owned::ownedCopying is disabled: a handle has exactly one owner.owned::ownedMoves ownership; other becomes empty.owned::resetReleases the owned handle now and leaves the object empty.owned::~ownedReleases the owned handle, if any.qt_client_configurationConnection and identity settings of a qt_client_worker.qt_client_configuration::anonymousActivate anonymously instead of with user_name and user_secret.qt_client_configuration::application_uriApplicationUri, at most 4096 bytes; must match the client certificate.qt_client_configuration::certificate_derClient application instance certificate (DER, at most 64 KiB).qt_client_configuration::endpointopc.tcp:// endpoint URL in UTF-8, at most 4096 bytes.qt_client_configuration::flagsBitwise OR of ::pdcomm_opcua_option_flags values.qt_client_configuration::modeRequested ::pdcomm_opcua_security_mode value.qt_client_configuration::policyRequested ::pdcomm_opcua_policy value.qt_client_configuration::private_key_pemPrivate key of that certificate (PEM, at most 64 KiB).qt_client_configuration::timeout_msTimeout of each network exchange and each outstanding request, 1 to 300000 ms.qt_client_configuration::trusted_server_derServer certificate to trust (DER, at most 64 KiB).qt_client_configuration::user_nameUTF-8 user name for a UserNameIdentityToken; used when anonymous is false.qt_client_configuration::user_secretUTF-8 password, at most 16 KiB; used when anonymous is false.qt_client_failureA failure delivered by qt_client_worker::failed().qt_client_failure::correlationCorrelation of the failed request, or 0 for a worker failure.qt_client_failure::phase"begin", "response", "abort" or "worker".qt_client_failure::status::pdcomm_opcua_status value of the failure.qt_client_failure::textEnglish detail text, copied in the worker thread right after the native call.qt_client_responseA response delivered by qt_client_worker::completed().qt_client_response::correlationCorrelation that the application passed to qt_client_worker::submit().qt_client_response::metadataResponse metadata: request ID, encoding ID and serviceResult.qt_client_response::request_idNative request ID (the requestHandle) of the request.qt_client_response::valueThe owned response. It survives the client and the worker; its const copy() and info() may be called from any thread, and the native buffer is released with the last reference.qt_client_response_ptrShared, immutable response passed by queued signals.qt_client_stopHow qt_client_worker::request_stop() ends the worker.qt_client_stop::abortStop at the next check, discard pending work and release the client without a protocol close.qt_client_stop::drainComplete every admitted request, then close the session and channel.qt_client_terminalFinal report delivered by qt_client_worker::stopped().qt_client_terminal::abortedTrue when the worker ended any other way; always !orderly.qt_client_terminal::acceptedRequests admitted by submit().qt_client_terminal::completedRequests that ended with a response or a "begin" or "response" failure.qt_client_terminal::discardedRequests that ended with an "abort" failure.qt_client_terminal::orderlyTrue when a drain finished with CloseSession and channel close.qt_client_terminal::reasonWhy the worker ended: "drained-and-closed", "aborted", "native-error", "adapter-error" or "restart-rejected".qt_client_workerOne-shot QThread that owns a native OPC UA client.qt_client_worker::completedA validated response arrived; the request has ended.qt_client_worker::failedA request or the worker failed; see qt_client_failure.qt_client_worker::maximum_commandsMaximum number of admitted requests that are queued or in flight.qt_client_worker::maximum_queued_bytesMaximum size of one request and of all queued, unsent requests together (4 MiB).qt_client_worker::operator=Copy assignment is disabled.qt_client_worker::pendingA request was sent to the server.qt_client_worker::qt_client_workerCopying is disabled.qt_client_worker::qt_client_workerCreates a worker; start() begins the connection.qt_client_worker::readyThe session is activated and requests are being sent.qt_client_worker::request_stopAsks the worker to stop; thread-safe.qt_client_worker::stoppedThe worker has ended; always the last signal of a run.qt_client_worker::submitQueues one UA Binary service request; thread-safe.qt_client_worker::~qt_client_workerRequests an abort, waits for the thread and wipes the credentials.require_versionChecks that the loaded library implements ABI 0x00000002.responseOwned, validated UA Binary service response.response::infoReturns the response metadata.response::responseTakes ownership of a response handle.serverIn-memory OPC UA server with variables in namespace 2.server::add_variableAdds a Variable node below the Objects folder.server::closeCloses the listener and aborts every channel.server::createCreates and binds a server.server::local_addressReturns the socket address the server listens on.server::pollAccepts connections and processes requests once, without blocking.server::read_valueReads the Value attribute as a local, authenticated user.server::set_valueWrites the Value attribute as a local, authenticated user.server_optionsReturns server options filled with the library defaults.ResponseInfo.BinaryIdThe numeric binary encoding ID (namespace 0) of the response body: the expected response type, or ServiceFault.ResponseInfo.RequestIdThe client-local request ID returned by Client.Begin.ResponseInfo.ServiceStatusThe serviceResult status code from the response header; a Bad code has the top bit (0x80000000) set.SecurityMode.NoneMessages are neither signed nor encrypted; only valid with SecurityPolicy.None.SecurityMode.SignMessages are signed.SecurityMode.SignAndEncryptMessages are signed and encrypted; the default.SecurityPolicy.Aes128Sha256RsaOaepThe Aes128_Sha256_RsaOaep policy.SecurityPolicy.Aes256Sha256RsaPssThe Aes256_Sha256_RsaPss policy; the default.SecurityPolicy.Basic256Sha256The Basic256Sha256 policy.SecurityPolicy.NoneNo security (http://opcfoundation.org/UA/SecurityPolicy#None); requires explicit opt-in.VariableFlags.NoneRead-only, and readable only by authenticated (non-anonymous) sessions.VariableFlags.PublicAnonymous sessions may access the variable as well.VariableFlags.WritableClients may write the value.BinaryBuffer.CopyCopies the buffer's contents into a new array.BinaryBuffer.DisposeReleases the native buffer.Client.ActivateAnonymousActivates the session with an anonymous identity.Client.ActivateUserNameActivates the session with a user name and password identity.Client.BeginSends a service request.Client.CloseCloses the session and the secure channel in an orderly way.Client.ConnectOpens a secure channel to a server and creates a session.Client.DiscoverRequests the endpoints of a server without creating a session.Client.DisposeReleases the client; an open connection is aborted without a protocol close.Client.PollSends queued request data and reads the responses that have arrived, without waiting for new data.Client.TakeTakes the response to a request if it has arrived.ClientOptions.ClientOptionsInitializes a new instance with default values.License.HostIdGets the host id of this machine, which host-bound licenses (SECS/GEM runtime licenses) name.License.InstallInstalls license text, replacing text installed earlier through this method.License.StatusGets the license status of the OPC UA library.Server.AddVariableAdds a variable below the Objects folder.Server.CloseStops accepting connections and aborts open channels.Server.CreateCreates a server and binds its listening socket.Server.DisposeReleases the server, aborting open channels if it is still running.Server.LocalAddressGets the socket address the server is bound to, for example to learn the port chosen for port 0.Server.PollAccepts connections and serves pending requests without waiting for new data.Server.ReadValueReads the current value of a variable from the application.Server.SetValueSets the value of a variable from the application.ServerOptions.ServerOptionsInitializes a new instance with default values.OpcUaClient.AbiVersionGets the ABI version reported by the native library, as major in the upper 16 bits and minor in the lower 16 bits.ClientOptions.AllowNoneGets whether SecurityPolicy.None may be used; it is rejected unless this is true.ClientOptions.ApplicationUriGets the client's application URI; default urn:pdcomm:opcua:client.ClientOptions.CertificateDerGets the client's application instance certificate, DER-encoded; empty for none.ClientOptions.ModeGets the message security mode; default SecurityMode.SignAndEncrypt.ClientOptions.PolicyGets the security policy of the secure channel; default SecurityPolicy.Aes256Sha256RsaPss.ClientOptions.PrivateKeyPemGets the private key of ClientOptions.CertificateDer, PEM-encoded; empty for none.ClientOptions.TimeoutMsGets the timeout of each network exchange, in milliseconds; default 10000. DNS resolution is not covered.ClientOptions.TrustedServerDerGets the server certificate to trust explicitly, DER-encoded; empty for none.ClientOptions.UserSecretHeaderPolicyOnlyGets whether new RSA-encrypted user secrets omit their outer encryption algorithm URI, so that the authenticated security header selects the policy. Set it only when the server requires it; legacy-format tokens still carry the algorithm URI.OpcUaException.LicenseRequiredGets whether the call was refused because no valid PDComm license grants the module it needs (opcua-client for discovery and connect, opcua-server for server creation); native status 11.OpcUaException.NativeStatusGets the native status code: 1 invalid input, 2 invalid handle, 3 internal error, 4 buffer too small, 5 runtime error (for example a network, security or protocol failure), 7 busy, 8 poisoned, 9 limit exceeded, 10 closed, or 11 license required.Response.InfoGets the response's request ID, encoding ID and service status.ServerOptions.AllowNoneGets whether the server also offers an endpoint without security; default false.ServerOptions.ApplicationUriGets the server's application URI; default urn:pdcomm:opcua:server.ServerOptions.CertificateDerGets the server's application instance certificate, DER-encoded.ServerOptions.EndpointGets the endpoint URL that the server advertises; default opc.tcp://localhost:4840/pdcomm. With port 0 the advertised endpoints use the port actually bound.ServerOptions.MaxConnectionsGets the largest number of concurrent TCP connections; default 33.ServerOptions.MaxSessionsGets the largest number of concurrent sessions; default 32.ServerOptions.PrivateKeyPemGets the private key of ServerOptions.CertificateDer, PEM-encoded.ServerOptions.TrustedClientDerGets the one client certificate to trust explicitly, DER-encoded; empty for none.BinaryBufferAn immutable byte buffer owned by the PDComm OPC UA native library.ClientAn OPC UA client session driven by the caller: send UA Binary service requests and poll for their responses.ClientOptionsSecurity, identity and timing options for Client.Connect.LicenseInstalls and inspects the PDComm license of the OPC UA native library.OpcUaExceptionThe exception thrown when a PDComm OPC UA native call fails.ResponseA validated OPC UA service response taken from a Client.ResponseInfoMetadata of a validated OPC UA service response.SecurityModeOPC UA message security modes (MessageSecurityMode).SecurityPolicyOPC UA security policies (OPC 10000-7) supported for the secure channel.ServerAn OPC UA server with an in-memory address space, driven by the caller.ServerOptionsEndpoint, identity, trust and capacity options for Server.Create.VariableFlagsAccess options of a variable added with Server.AddVariable.
No API matches the filter.