ORB::get_service_information

Overview Describes what services of a particular type are available.
Original class CORBA::ORB
Exceptions CORBA::SystemException


Intended Usage

This method is intended to be used by client and server applications to determine what services of a particular type (such as Security services) are available. The result of CORBA::ORB::get_service_information does not vary during the lifetime of a single process.

Syntax

  CORBA::Boolean get_service_information (CORBA::ServiceType service_type, 
    CORBA::ServiceInformation& service_information);

Input parameters

service_type
The identifier of the service for which information is needed. For example, use CORBA::Security to obtain information about what security services are available in the calling process.
service_information
A CORBA::ServiceInformation variable, passed by reference, to be initialized by the CORBA::ORB::get_service_information method.

Return values

CORBA::Boolean
Zero indicates that the requested service is not available, and hence that the service_information parameter has not been updated. A nonzero return value indicates that the service_information parameter has been initialized.

Example

  #include "corba.h"
  int main(int argc, char* argv[])
  {
    int rc = 0;
    /* assume cop initialized */
    extern CORBA::ORB_ptr cop;
    CORBA::ServiceInformation si ;
    /* request service information for CORBA::Security */
    CORBA::Boolean retval = 
      cop->get_service_information(CORBA::Security, si);
    return rc;
  }

Related reference
CORBA module



Searchable topic ID:   rcor_modo25
Last updated: Jun 21, 2007 8:07:48 PM CDT    WebSphere Business Integration Server Foundation, Version 5.0.2
http://publib.boulder.ibm.com/infocenter/wasinfo/index.jsp?topic=/com.ibm.wasee.doc/info/ee/corba/ref/rcor_modo25.html

Library | Support | Terms of Use | Feedback