AbstractSessionOpenServiceAsync Method (String, CorrelationID) |
Initiates an asynchronous request to open a service.
Namespace:
Bloomberglp.Blpapi
Assembly:
Bloomberglp.Blpapi (in Bloomberglp.Blpapi.dll) Version: 3.24.11.1
Syntax public void OpenServiceAsync(
string serviceName,
CorrelationID correlationId
)
Public Sub OpenServiceAsync (
serviceName As String,
correlationId As CorrelationID
)
public:
virtual void OpenServiceAsync(
String^ serviceName,
CorrelationID^ correlationId
) sealed
abstract OpenServiceAsync :
serviceName : string *
correlationId : CorrelationID -> unit
override OpenServiceAsync :
serviceName : string *
correlationId : CorrelationID -> unit
Parameters
- serviceName
- Type: SystemString
The name of the service that is to be opened.
- correlationId
- Type: Bloomberglp.BlpapiCorrelationID
A correlation Id for correlating this request.
Implements
IAbstractSessionOpenServiceAsync(String, CorrelationID)Exceptions Exception | Condition |
---|
InvalidOperationException |
The session is not started.
|
DuplicateCorrelationIDException |
The specified correlationId is already active for this Session.
|
Remarks
Initiates a request to open the service identified by
serviceName.
serviceName must be 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.
See Also