IiopOrbixPing Function

Action

Sends the _IT_PING request to an object.

Include file

IIOP.bdh

Syntax

IiopOrbixPing( in hIiop : number ): number;

Return value

  • Handle to the OrbixWeb object if successful

  • 0 if an error occurred

Parameter Description
hIiop Handle to a CORBA object. The corresponding object structure has to contain a dummy key that enables the Orbix daemon locating the object

Example

dcltrans
  transaction TMain
  const
    ORBIX_HOST := "192.168.20.55"; // Orbix host
    ORBIX_PORT := 1571;            // default Orbix port
  var
    hDaemon, hObject: number;
  begin
    // global settings
    IiopSetMaxGiopVersion("1.2");
    IiopSetByteOrder(IIOP_LITTLE_ENDIAN);
    IiopSetPrincipal("principal", Strlen("principal")+1);
 
    // OrbixWeb bootstrapping
    hDaemon := IiopOrbixDaemonBind(ORBIX_HOST, ORBIX_PORT);

    // send _IT_PINg request to Orbix daemon
    hObject := IiopOrbixPing(hDaemon);
 
    // release objects
    IiopObjectRelease(hDaemon);
    IiopObjectRelease(hObject);
end TMain;