OpenServiceAsync Method (uri, correlationId)

Initiates an asynchronous request to open a service.

Declaration Syntax

Visual Basic

Visual C++

public void OpenServiceAsync(
	string uri,
	CorrelationID correlationId
)

Public Sub OpenServiceAsync ( 
	uri As String,
	correlationId As CorrelationID
)

public:
void OpenServiceAsync(
	String^ uri, 
	CorrelationID^ correlationId
)

Parameters

uri (String): URI of the service that is to be opened.

correlationId (CorrelationID): A correlation Id for correlating this request.

Remarks

Initiates a request to open the service having the specified uri The specified 'uri' must contain a fully qualified service name. That is it must be of the form "//[namespace]/[service-name]"

Once the request has completed, a SERVICE_STATUS event will be generated indicating the result of the request. The correlationId will be returned in generated message. It can also be used to cancel this request before it completes by calling the Cancel operation. Note the supplied correlationId MUST BE unique from any "active" correlation supplied to this session via any operation(e.g., "subscribe", "sendRequest"). A correlation id is active if the request for which it was supplied is still pending, or if it refers to a subscription request that has not been terminated either explicitly or by an unsolicited termination.

Exceptions

Exception	Condition
InvalidOperationException	The session is not started.
DuplicateCorrelationIDException	The specified correlationId is already active for this Session.