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

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 Understanding 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.