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;