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.