IiopObjectGetComponent Function

Action

Retrieves a component from an Internet profile of an IOR.

Include file

IIOP.bdh

Syntax

IiopObjectGetComponent( in  hIiop       : number,
                        in  nProfile    : number,
                        in  nComponent  : number,
                        out nTag        : number,
                        out sData       : string,
                        in  nBufferSize : number optional,
                        out nLen        : number optional ): boolean;

Return value

true if successful
false otherwise

Parameter	Description
hIiop	Handle to a CORBA Object.
nProfile	Index of the Internet profile. Set this parameter to IIOP_FIRST or IIOP_LAST for the first or the last profile, respectively. The index of the first profile is zero (0).
nComponent	Index of the component within the selected profile. Set this parameter to IIOP_FIRST or IIOP_LAST for the first or the last component, respectively. The index of the first component is zero (0).
nTag	Variable receiving the component tag. Component tags are described in the CORBA specification.
sData	Buffer receiving the component data.
nBufferSize	Size of the buffer that receives the component data in bytes (optional).
nLen	Variable receiving the amount of component data (in bytes) that is copied into the buffer (optional).

Example

var
  hSSLBank: number;
 
dcltrans
  transaction TMain
  var
    sData, sDataHex : string;
    nType, nLen : number;
  begin
    if IiopObjectGetComponent(hSSLBank, IIOP_FIRST, IIOP_FIRST, nType,
        sData, STRING_COMPLETE, nLen) and (nType = 20) then
      Bin2Hex(sData, nLen, sDataHex);
      writeln("hSSLBank contains an SSL tag: " + sDataHex);
    end;
  end TMain;