IiopGetWString Function

Action

Retrieves a wide string return parameter from a CORBA object. This function can be used to get the return parameters of an operation.

Include file

IIOP.bdh

Syntax

IiopGetWString( in  hIiop     : number,
                out sBuffer   : string optional,
                in  nSize     : number optional,
                out nReceived : number optional ): boolean;

Return value

  • true if successful

  • false otherwise

Parameter Description
hIiop Handle to a CORBA object.
sBuffer Buffer that will receive the wide string return parameter from the CORBA object (optional).
nSize Size of the buffer that will receive the wide string return parameter from the CORBA object (optional).
nReceived Variable that will receive the number of bytes that were actually retrieved from the CORBA object (optional).

Example

dcltrans
  transaction TGetWChar
  const
    HOST   := "192.168.20.21"; // server
    PORT   := 1052;            // port
    KEY    := "...\h00";       // key
    KEYLEN := 4;               // key length
  var
    hIiop   : number;
    sString : string;
  begin
    IiopSetMaxGiopVersion("1.2");
    IiopSetByteOrder(IIOP_BIG_ENDIAN);

    // retrieve handle to server
    IiopObjectCreate(hIiop, "IDL:DemoObject:1.0", "1.2", HOST, PORT, KEY, KEYLEN);

    // call request "NextWString"
    IiopRequest(hIiop, "NextWString");

     // retrieve wide character return parameter
    IiopGetWString(hIiop, sString);
    IiopObjectRelease(hIiop);
  end TGetChar;