determine the IPX address of a given named server
cc . . . -lsaprqsts
int ispx_get_address(server_name, server_type, adrs_ptr, adrs_cnt)
Given a server name, the ispx_get_address call
determines and returns a list of IPX addresses
corresponding to the named server. The number of addresses
returned is limited by adrs_cnt.
Because this function returns no more than
the specified number of addresses,
a client application must
allocate a large enough buffer to accept the addresses.
Specifically, the size of the address buffer
should be at least as large as the product of
adrs_cnt and the size of ipxAddr_t.
The arguments to this function are:
specifies the server name.
specifies a Novell object type.
specifies a buffer where the service addresses are
to be returned on successful completion.
specifies the maximum number of addresses to be returned.
the ispx_get_address call
returns the number of addresses if successful or a value
less than zero if unsuccessful.
On failure, return values are interpreted as follows:
the TLI t_open of /dev/ipx failed.
the TLI t_bind call failed.
the SAP request type was invalid.
the TLI t_sndudata call failed, and hence, the
SAP request was not transmitted.
the poll call failed.
The ispx_service_query function polls
the connection end-point until all responses
have been processed.
the TLI t_rcvudata call failed.
the TLI t_unbind call failed.
the TLI t_close call failed.
the name could not be resolved, that is, an address
matching the specified name could not be found.
buffers required by the library cannot be allocated.
to dynamically allocate a
larger data buffer for the library failed.
(This can happen when a buffer previously allocated
by the library is insufficient to hold all of the
ispx_get_address is not part of any currently supported standard;
it is an extension of AT&T System V provided by The Santa Cruz Operation, Inc.
© 2003 Caldera International, Inc. All rights reserved.
SCO OpenServer Release 5.0.7 -- 11 February 2003