Data Values

The values that need to be included in the data string depend on the particular service provider. Modem providers, for instance, need a telephone number in their address, whereas local area network (LAN) providers might need a port number. This section provides a detailed description of the standard data values. It also includes a key name that can be used in place of the literal string. These names are defined in Dpaddr.h. For more information about using these values, see DirectPlay Address Objects.

• Application Instance
• Baud
• Device
• Flow Control
• Host Name
• Parity
• Phone Number
• Port
• Program
• Provider
• Stop Bits
• NAT Resolver
• NAT Resolver User String
• Name Information
• Processor
• Scope
• Traversal Mode

Application Instance

An optional globally unique identifier (GUID) that identifies an application instance. This value is used when specifying the game that is to be connected to.

Key Name: DPNA_KEY_APPLICATION_INSTANCE

Key String: "applicationinstance"

Data Type: GUID

Providers: All

Valid Values: Any valid application instance GUID.

Baud

The baud rate.

Key Name: DPNA_KEY_BAUD

Key String: "baud"

Data Type: DWORD

Providers: Modem and serial

Valid Values: Any valid baud rate. You can set this value to the appropriate integer, or you can use one of the following predefined values from Dpaddr.h.

Device

A GUID that identifies the device on the local computer that will be used. If the service provider supports all adapters, you do not need to specify a device.

Key Name: DPNA_KEY_DEVICE

Key String: "device"

Data Type: GUID

Providers: All, but for device addresses only, not host addresses

Valid Values: Any valid device GUID.

Flow Control

The type of flow control to be used.

Key Name: DPNA_KEY_FLOWCONTROL

Key String: "flowcontrol"

Data Type: String

Providers: Serial and modem

Valid Values: Any of the following predefined values from Dpaddr.h.

Host Name

The name of a remote host computer.

Key Name: DPNA_KEY_HOSTNAME

Key String: "hostname"

Data Type: String

Providers: All, but for host addresses only, not device addresses

Valid Values: A fully-qualified host name, or a dotted address.

Parity

The parity of the connection.

Key Name: DPNA_KEY_PARITY

Key String: "parity"

Data Type: String

Providers: Serial and modem

Valid Values: Any of the following predefined values from Dpaddr.h.

Phone Number

A phone number.

Key Name: DPNA_KEY_PHONENUMBER

Key String: "phonenumber"

Data Type: String

Providers: Modem

Valid Values: Any valid phone number.

Port

An optional port number. For more information, see DirectPlay and Ports.

Key Name: DPNA_KEY_PORT

Key String: "port"

Data Type: DWORD

Providers: Internet Protocol (IP) and Internetwork Packet Exchange (IPX)

Valid Values: Any 16-bit integer. Only the lower 16 bits of the value are valid. If you do not specify a port, Microsoft® DirectPlay® will choose one for you.

Program

An optional application GUID.

Key Name: DPNA_KEY_PROGRAM

Key String: "program"

Data Type: GUID

Providers: All

Valid Values: Any valid application GUID.

Provider

A GUID that identifies the DirectPlay service provider that will be used. For more information, see DirectPlay Service Providers.

Key Name: DPNA_KEY_PROVIDER

Key String: "provider"

Data Type: GUID

Providers: All

Valid Values: Any valid service provider GUID.

Stop Bits

The number of stop bits.

Key Name: DPNA_KEY_STOPBITS

Key String: "stopbits"

Data Type: String

Providers: Serial and modem

Valid Values: Any of the following predefined values from Dpaddr.h.

NAT Resolver

A name of a IDirectPlay8NATResolver server. See Network Address Translation, Firewalls, and Proxies for more information.

Key Name: DPNA_KEY_NAT_RESOLVER

Key String: "natresolver"

Data Type: String

Providers: All, but for device addresses only, not host addresses

Valid Values: A fully-qualified name, or a dotted address.

NAT Resolver User String

A password to allow access to the IDirectPlay8NATResolver server. See Network Address Translation, Firewalls, and Proxies for more information.

Key Name: DPNA_KEY_NAT_RESOLVER_USER_STRING

Key String: "natresolveruserstring"

Data Type: String

Providers: All, but for device addresses only, not host addresses

Valid Values: Any valid password.

Name Information

The name of a Microsoft Windows® Powered Pocket PC 2002 device. See Bluetooth Service Provider for more information.

Key Name: DPNA_KEY_NAMEINFO

Key String: "nameinfo"

Data Type: String

Providers: None. This component is only for information returned from an enumeration. To connect to the device, use the DPNA_KEY_HOSTNAME component.

Valid Values: A friendly name.

Processor

The processor number.

Key Name: DPNA_KEY_PROCESSOR

Key String: "processor"

Data Type: String

Providers: All

Valid Values: A valid processor number.

Scope

Not implemented.

Traversal Mode

Enable or disable traversal mode. See Network Address Translation, Firewalls, and Proxies for more information.

Key Name: DPNA_KEY_TRAVERSALMODE

Key String: "traversalmode"

Data Type: String

Providers: All

Valid Values: Any of the following predefined values from Dpaddr.h.