NWCCGetConnRefAddress(3nw)


NWCCGetConnRefAddress -- returns the transport address for the specified connection reference

Synopsis

   #include <nwclxcon.h> 
   

N_EXTERN_LIBRARY NWRCODE NWCCGetConnRefAddress (nuint32 connRef, nuint32 bufferLen, pNWCCTranAddr tranAddr);

Description

The parameters are as follows:

connRef
(IN) Specifies the conneciton reference for which to return the transport address.

bufferLen
(IN) Specifies the size, in bytes, of the structure field buffer of NWCCTranAddr.

tranAddr
(OUT) Points to the NWCCTranAddr structure containing the address.

Return values

0x0000
SUCCESS

0x8801
NWE_CONN_INVALID

0x8867
NWE_INSUFFICIENT_RESOURCES

0x8868
NWE_STRING_TRANSLATION

0x8869
NWE_ACCESS_VIOLATION

0x886C
NWE_RESOURCE_LOCK

0x8872
NWE_INVALID_OWNER

Notices

You need to ensure that bufferLen is large enough to contain the returned address; otherwise, NWCCGetConnAddress will fail and return NWE_INSUFFICIENT_RESOURCES. Call NWCCGetConnAddressLength to determine the address length and then allocate enough memory in the buffer for bufferLen.

len in NWCCTranAddr will contain the address length upon return.

Services

Connection


30 January 1998
© 1998 The Santa Cruz Operation, Inc. All rights reserved.