Export (0) Print
Expand All
COM
id
in
int
odl
out
ptr
ref
Expand Minimize
This topic has not yet been rated - Rate this topic

ncacn_spx attribute

The ncacn_spx keyword identifies SPX as the protocol family for the endpoint. This protocol family is obsolete and should not be used in new applications.


endpoint("ncacn_spx:link-address[port-name]")

Parameters

link-address

Specifies the host server. This may be either a character string (the server name), or a 20-digit hexadecimal number that consists of the host server's network address (8 digits) concatenated with the node address (12 digits). See Remarks for instructions on how to obtain the network address and node address. A NULL string specifies the local computer.

port-name

Specifies an optional 16-bit number that represents the socket address. Values can range from 1 to 65,535. When no value is specified, the endpoint-mapping service selects a valid port-name value.

Remarks

When you use the ncacn_spx transport, the server name is exactly the same as the 32-bit Windows name. However, since the names are distributed using Novell protocols, they must conform to the Novell naming conventions. If a server name is not a valid Novell name, servers will not be able to create endpoints with the ncacn_spx transport. The following is a partial list of characters prohibited in Novell server names:

" * + . / : ; < = > ? [ ] \ |

The ncacn_spx transport is not supported by the version of NWLink supplied with MS Client 3.0.

16-bit Windows client applications that use the ncacn_spx transport require that the file Nwipxspx.dll be installed in order to run under the WOW subsystem. Contact Novell to obtain this file.

Note  To obtain the network and node addresses, use Novell's comcheck utility, or the Novell-defined API IPXGetInternetAddress. On Windows, you can also obtain these addresses with the ipxroute config command.

The syntax of the SPX transport port string, like all port strings, is defined independently of the IDL specification. The compiler performs some syntax checking but does not guarantee that the endpoint specification is correct. Some errors may be reported at run time rather than at compile time.

Examples

[
    uuid(12345678-4000-2006-0000-20000000001a), 
    version(1.1), 
    endpoint("ncacn_spx:[1000]") 
] 
interface iface
{
    // Interface definition statements.
}

See also

endpoint
Interface Definition (IDL) File
ncacn_at_dsp
ncacn_dnet_nsp
ncacn_ip_tcp
ncacn_nb_ipx
ncacn_nb_nb
ncacn_nb_tcp
ncacn_np
ncacn_vns_spp
ncalrpc
ncadg_ipx
ncadg_ip_udp
string binding

 

 

Did you find this helpful?
(1500 characters remaining)
Thank you for your feedback

Community Additions

ADD
Show:
© 2014 Microsoft. All rights reserved.