NWCCGetConnAddress(3nw)


NWCCGetConnAddress -- returns the transport address for the specified connection

Synopsis

   #include <nwclxcon.h> 
   

N_EXTERN_LIBRARY NWRCODE NWCCGetConnAddress (NWCONN_HANDLE connHandle, nuint32 bufferLen, pNWCCTranAddr tranAddr);

Description

The parameters are as follows:

connHandle
(IN) Specifies the connection handle 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 transport address.

Return values

0x0000
SUCCESS

0x8801
NWE_CONN_INVALID

0x8867
NWE_INSUFFICIENT_RESOURCES

0x8868
NWE_STRING_TRANSLATION

0x8869
NWE_ACCESS_VIOLATION

Notices

Be sure 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.