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.