SetIPXFrameTypeNetworkPairs method of the Win32_NetworkAdapterConfiguration class

[The Internetwork Packet Exchange (IPX) technology is no longer available for use as of Windows Server 2008, and this method is obsolete.]

Windows Server 2003 : The SetIPXFrameTypeNetworkPairs WMI class method is used to set the Internetwork Packet Exchange (IPX) network number and frame pairs for this network adapter.

This topic uses Managed Object Format (MOF) syntax. For more information about using this method, see Calling a Method.

Syntax

uint32 SetIPXFrameTypeNetworkPairs(
  [in] string IPXNetworkNumber[],
  [in] uint32 IPXFrameType[]
);

Parameters

IPXNetworkNumber [in]

Array of characters that uniquely identify an IPX network. This IPX number is sometimes referred to as the External Network Number, and it must be unique for each network segment. The values in this string list must have a corresponding value in the IPXFrameType parameter that identifies the packet frame type used for this network.

IPXFrameType [in]

Integer array of frame type identifiers. The values in this array correspond to the elements in the IPXNetworkNumber parameter.

Ethernet II (0)

Ethernet 802.3 (1)

Ethernet 802.2 (2)

Ethernet SNAP (3)

AUTO (255)

Return value

The SetIPXFrameTypeNetworkPairs method returns one of the following values. For more information on error codes, see WMI Error Constants or WbemErrorEnum. For general HRESULT values, see System Error Codes.

Return code/value Description
Successful completion, no reboot required 0

Successful completion, no reboot required.

Successful completion, reboot required 1

Successful completion, reboot required.

Method not supported on this platform 64

Method not supported on this platform.

Unknown failure 65

Unknown failure.

Invalid subnet mask 66

Invalid subnet mask.

An error occurred while processing an Instance that was returned 67

An error occurred while processing an instance that was returned.

Invalid input parameter 68

Invalid input parameter.

More than 5 gateways specified 69

More than five gateways specified.

Invalid IP address 70

Invalid IP address.

Invalid gateway IP address 71

Invalid gateway IP address.

An error occurred while accessing the Registry for the requested information 72

An error occurred while accessing the registry for the requested information.

Invalid domain name 73

Invalid domain name.

Invalid host name 74

Invalid host name.

No primary/secondary WINS server defined 75

No primary or secondary WINS server defined.

Invalid file 76

Invalid file.

Invalid system path 77

Invalid system path.

File copy failed 78

File copy failed.

Invalid security parameter 79

Invalid security parameter.

Unable to configure TCP/IP service 80

Unable to configure TCP/IP service.

Unable to configure DHCP service 81

Unable to configure DHCP service.

Unable to renew DHCP lease 82

Unable to renew DHCP lease.

Unable to release DHCP lease 83

Unable to release DHCP lease.

IP not enabled on adapter 84

IP not enabled on adapter.

IPX not enabled on adapter 85

IPX not enabled on adapter.

Frame/network number bounds error 86

Frame or network number bounds error.

Invalid frame type 87

Invalid frame type.

Invalid network number 88

Invalid network number.

Duplicate network number 89

Duplicate network number.

Parameter out of bounds 90

Parameter out of bounds.

Access denied 91

Access denied.

Out of memory 92

Out of memory.

Already exists 93

Already exists.

Path, file or object not found 94

Path, file, or object not found.

Unable to notify service 95

Unable to notify service.

Unable to notify DNS service 96

Unable to notify DNS service.

Interface not configurable 97

Interface not configurable.

Not all DHCP leases could be released/renewed 98

Not all DHCP leases could be released or renewed.

DHCP not enabled on adapter 100

DHCP not enabled on adapter.

Other 101–4294967295

 

Remarks

Windows uses an IPX network number for routing purposes. A network number is assigned to each configured frame type and network adapter combination on your computer system. This number is sometimes referred to as the external network number, and it must be unique for each network segment. If the frame type is set to AUTO, the network number should be zero.

Examples

The Modify the IPX Frame Type VBScript sample configures the IPX network number and frame type for a network adapter.

Requirements

Minimum supported client

None supported

Minimum supported server

Windows Server 2003

End of client support

None supported

End of server support

Windows Server 2003

Namespace

Root\CIMV2

MOF

CIMWin32.mof

DLL

CIMWin32.dll

See also

Computer System Hardware Classes

Win32_NetworkAdapterConfiguration

WMI Tasks: Networking

WMI Tasks: Accounts and Domains

IPv6 and IPv4 Support in WMI