Click or drag to resize
ProviderSession Methods

The ProviderSession type exposes the following members.

Methods
  NameDescription
Public methodActivateSubServiceCodeRange
Activates sub-service code range of the specified [begin, end] and the specified priority to an already registered service.

Numerically greater values of priority indicate higher priorities.The behavior is undefined unless begin, end and priority are between 0 and 2^24 (2 to the power of 24) and the service has already been registered.

Public methodCancel(CorrelationID)
Cancels an outstanding request or a subscription represented by the specified correlationId.
(Inherited from AbstractSession.)
Public methodCancel(IListCorrelationID)
Cancels outstanding requests or subscriptions represented by the specified list of correlationIds.
(Inherited from AbstractSession.)
Public methodCancel(CorrelationID, String)
Cancels an outstanding request or a subscription represented by the specified correlationId.
(Inherited from AbstractSession.)
Public methodCancel(IListCorrelationID, String)
Cancels outstanding requests or subscriptions represented by the specified list of correlationIds.
(Inherited from AbstractSession.)
Public methodCreateIdentity
Returns a new Identity which is valid but has not been authorized.
(Inherited from AbstractSession.)
Public methodCreateTopic Obsolete.
Creates a new Topic object based on the specified 'message'. The 'message' must be one of the following types: SUBSCRIPTION_STARTED, SUBSCRIPTION_STOPPED, RECAP or RESOLUTION_SUCCESS. If the 'message' is not valid then invoking isValid() on the returned Topic will return false.
Public methodCreateTopics(TopicList)
Creates the topics in the specified 'topicList' and updates the 'topicList' with the results of the resolution and creation process.
Public methodCreateTopics(TopicList, ResolveMode)
Creates the topics in the specified 'topicList' and updates the 'topicList' with the results of the resolution and creation process.
Public methodCreateTopics(TopicList, ResolveMode, Identity)
Creates the topics in the specified 'topicList' and updates the 'topicList' with the results of the resolution and creation process.
Public methodCreateTopicsAsync(TopicList)
Begins the creation of the topics in the specified 'topicList'.
Public methodCreateTopicsAsync(TopicList, ResolveMode)
Begins the creation of the topics in the specified 'topicList'.
Public methodCreateTopicsAsync(TopicList, ResolveMode, Identity)
Begins the creation of the topics in the specified 'topicList'.
Public methodCreateUserHandle Obsolete. (Inherited from AbstractSession.)
Public methodDeactivateSubServiceCodeRange
De-activates sub-service code range specified by [begin, end] from to an already registered service. The behavior is undefined unless 'begin' and 'end' are between 0 and 2^24 (2 to the power of 24) and the service has already been registered.
Public methodDeleteTopic
Removes one reference from the specified 'topic'.
Public methodDeleteTopics
Deletes each topic in the specified 'topics'.
Public methodDeregisterService
Deregisters the service identified by the specified 'uri'.
Public methodGenerateToken
Return a generated token to be used for authorization.
(Inherited from AbstractSession.)
Public methodGenerateToken(CorrelationID)
Return a generated token to be used for authorization.
(Inherited from AbstractSession.)
Public methodGenerateToken(CorrelationID, EventQueue)
Return a generated token to be used for authorization.
(Inherited from AbstractSession.)
Public methodGenerateToken(String, String, CorrelationID, EventQueue)
Return a generated token to be used for authorization.
(Inherited from AbstractSession.)
Public methodGetService
Returns a handle to a Service object representing the service identified by the specified uri.
(Inherited from AbstractSession.)
Public methodGetTopic
Finds a previously created Topic object based on the specified
message
Public methodNextEvent
Returns the next event available for processing on this session.
(Inherited from AbstractSession.)
Public methodNextEvent(Int64)
Returns the next event available for processing on this session.
(Inherited from AbstractSession.)
Public methodOpenService
Opens the service having the specified uri.
(Inherited from AbstractSession.)
Public methodOpenServiceAsync(String)
Issues an asynchronous request to open a service.
(Inherited from AbstractSession.)
Public methodOpenServiceAsync(String, CorrelationID)
Initiates an asynchronous request to open a service.
(Inherited from AbstractSession.)
Public methodPublish
Publish the specified 'event'.
Public methodRegisterService(String, Identity)

Attempts to register the service identified by the specified 'uri' and blocks until the service is either registered successfully or has failed to be registered. The specified 'providerIdentity' is used to verify permissions to provide the service being registered. Returns true if the service is registered successfully and false if the service cannot be registered successfully.

The 'uri' must begin with a full qualified service name. That is it must begin with "//{namespace}/{service-name}[/]". Any portion of the 'uri' after the service name is ignored.

This method does not return until a SERVICE_STATUS event has been generated. Note that if the session was created in asynchronous mode, the event may be processed before the function returns.

Public methodRegisterService(String, Identity, ServiceRegistrationOptions)

Attempts to register the service identified by the specified 'uri' and blocks until the service is either registered successfully or has failed to be registered. The specified 'providerIdentity' is used to verify permissions to provide the service being registered. Returns true if the service is registered successfully and false if the service cannot be registered successfully.

The 'uri' must begin with a full qualified service name. That is it must begin with "//{namespace}/{service-name}[/]". Any portion of the 'uri' after the service name is ignored.

This method does not return until a SERVICE_STATUS event has been generated. Note that if the session was created in asynchronous mode, the event may be processed before the function returns.

Public methodRegisterServiceAsync(String, Identity)
Begins the process of registering the service identified by the specified 'uri' with identity and returns immediately.
Public methodRegisterServiceAsync(String, Identity, CorrelationID)
Begins the process of registering the service identified by the specified 'uri' and returns immediately.
Public methodRegisterServiceAsync(String, Identity, ServiceRegistrationOptions)
Begins the process of registering the service identified by the specified 'uri' with identity and registration options, and returns immediately.
Public methodRegisterServiceAsync(String, Identity, CorrelationID, ServiceRegistrationOptions)
Begins the process of registering the service identified by the specified 'uri' with identity, CorrelationID and registration options. Returns immediately.
Public methodResolve(ResolutionList)
Resolves the topics in the specified 'resolutionList' and updates the 'resolutionList' with the results of the resolution process. All services referenced in the topics in the 'resolutionList' must already have been registered using registerService(). Once resolve() returns each entry in the 'resolutionList' will have been updated with a new status.
Public methodResolve(ResolutionList, ResolveMode)
Resolves the topics in the specified 'resolutionList' and updates the 'resolutionList' with the results of the resolution process.
Public methodResolve(ResolutionList, ResolveMode, Identity)
Resolves the topics in the specified 'resolutionList' and updates the 'resolutionList' with the results of the resolution process.
Public methodResolveAsync(ResolutionList)
Begins the resolution of the topics in the specified 'resolutionList'.
Public methodResolveAsync(ResolutionList, ResolveMode)
Begins the resolution of the topics in the specified 'resolutionList'.
Public methodResolveAsync(ResolutionList, ResolveMode, Identity)
Begins the resolution of the topics in the specified 'resolutionList'.
Public methodSendAuthorizationRequest(Request, Identity, CorrelationID)
Sends the specified authorizationRequest and update the specified identity with the results.
(Inherited from AbstractSession.)
Public methodSendAuthorizationRequest(Request, UserHandle, CorrelationID) Obsolete.
Deprecated since 3.3.0.0. Use SendAuthorizationRequest(Request, Identity, CorrelationID)instead.
(Inherited from AbstractSession.)
Public methodSendAuthorizationRequest(Request, Identity, CorrelationID, String)
Sends the specified authorizationRequest and update the specified identity with the results.
(Inherited from AbstractSession.)
Public methodSendAuthorizationRequest(Request, Identity, EventQueue, CorrelationID)
Sends the specified authorizationRequest and update the specified identity with the results.
(Inherited from AbstractSession.)
Public methodSendAuthorizationRequest(Request, UserHandle, CorrelationID, String) Obsolete. (Inherited from AbstractSession.)
Public methodSendAuthorizationRequest(Request, UserHandle, EventQueue, CorrelationID) Obsolete. (Inherited from AbstractSession.)
Public methodSendAuthorizationRequest(Request, Identity, EventQueue, CorrelationID, String)
Sends the specified authorizationRequest and update the specified identity with the results.
(Inherited from AbstractSession.)
Public methodSendAuthorizationRequest(Request, UserHandle, EventQueue, CorrelationID, String) Obsolete. (Inherited from AbstractSession.)
Public methodSendResponse(Event)
Sends the response event for previously received request
Public methodSendResponse(Event, Boolean)
Sends the response event for previously received request
Public methodSetEventHandler
Sets event specific event handlers
Public methodStart
Issues a blocking call to start the session.
(Inherited from AbstractSession.)
Public methodStartAsync
Initiates a non blocking call to start the session.
(Inherited from AbstractSession.)
Public methodStop
Stops this session.
(Inherited from AbstractSession.)
Public methodStop(AbstractSessionStopOption)
Stops the operation of this session.
(Inherited from AbstractSession.)
Public methodTryNextEvent
Tries to retrieve the next event available for processing on this session
(Inherited from AbstractSession.)
Top
Explicit Interface Implementations
  NameDescription
Explicit interface implementationPrivate methodIDisposableDispose
Dispose this Session object. It calls AbstractSession.Stop() to close the opened socket.
(Inherited from AbstractSession.)
Top
See Also