OBEX Registry Settings

A version of this page is also available for

Windows Embedded CE 6.0 R3

4/8/2010

The registry stores information necessary to configure the system for applications and hardware devices. The registry also contains information that the operating system (OS) continually references during operation.

Note

The default registry values vary depending on which Catalog items are included in your OS design.

You can change the registry settings for the OBEX server extensions. The registry key is HKEY_LOCAL_MACHINE\Software\Microsoft\OBEX\Services. The key can include one of the following subkeys:

  • Universally unique identifier (UUID)
  • String name
  • Set of hexadecimal digits

There is a subkey for each exported service. A subkey must evaluate to a TARGETID field in the OBEX request packet. For more information about OBEX requests, see the OBEX documentation under "Object Exchange Protocol" in the MSDN library.

The registry key can also contain the value for BluetoothSdpRecord, which is sent to Service Discovery Protocol (SDP) for OBEX. The OBEX server provides a channel ID for the record, registers it at startup, and unregisters it at shutdown.

You can change the registry settings for the OBEX server configuration parameters. The registry key is HKEY_LOCAL_MACHINE\Software\Microsoft\OBEX.

The following table shows the registry values.

Value Description

IsEnabled: REG_DWORD

If the value is 0, the server does not start on boot.

ServerTimeout: REG_DWORD

Specifies the time-out value, in ms, after which a service extension with no active connections is unloaded.

ConnectionTimeout: REG_DWORD

Specifies the time-out value, in ms, after which a physical connection with no activity is closed.

MaintPeriod: REG_DWORD

Specifies the time-out value, in ms, which refers to how often internal maintenance operations, such as compacting the heap, are performed.

Protocols: REG_SZ

A string value that contains the comma-separated list of transports used by the server.

Enables OBEX IrDA hint bit

The following table shows the registry values for the HKEY_LOCAL_MACHINE\Comm\IrDA registry key.

Value Description

Hints: REG_DWORD

Default setting is hexadecimal 8224. This DWORD indicates the device's IrDA capabilities. When two devices want to establish an IrDA connection, they exchange capabilities by using this value. Some devices require that specific capabilities are supported, and will not connect if the required support is not present.

The following list shows the meaning of the first two digits of the value. These can be used in combination. For example, in the default setting, 82 indicates that there is another byte of capabilities, and that this is a PDA or palmtop device.

  • 0x01 indicates that this device is PnP Compatible.
  • 0x02 indicates that this device is a PDA/palmtop.
  • 0x04 indicates that this device is a Computer.
  • 0x08 indicates that this device is a Printer.
  • 0x10 indicates that this device is a Modem.
  • 0x20 indicates that this device is a Fax.
  • 0x40 indicates that this device is provides LAN Access.
  • 0x80 indicates that there is another byte of capabilities.

The following list shows the meaning of the second two digits of the value. These can be used in combination. For example, in the default setting, 24 indicates IrObex and IrCOMM.

  • 0x01 indicates that this device supports Telephony.
  • 0x02 indicates that this device supports File Server.
  • 0x04 indicates that this device supports IrCOMM.
  • 0x08 is reserved.
  • 0x10 is reserved.
  • 0x20 indicates that this device supports IrOBEX.
  • 0x40 is reserved.
  • 0x80 indicates that there is another byte of capabilities.

IrDA and Bluetooth Transports

The following table shows the registry values for the HKEY_LOCAL_MACHINE\Software\Microsoft\Obex\Transports\{30a7bc02-59b6-40bb-aa2b-89eb49ef274e} registry key.

Value Description

Name: REG_SZ

Default Setting is IRDA. Specifies the IrDA transport.

The following table shows the registry values for the HKEY_LOCAL_MACHINE\Software\Microsoft\Obex\Transports\{30a7bc03-59b6-40bb-aa2b-89eb49ef274e} registry key.

Value Description

Name: REG_SZ

Default Setting is Bluetooth. Specifies the Bluetooth transport.

Enable the OBEX Server

Based on registry entries, OBEX is registered with Services.exe during device start up. The following table shows the registry values for the HKEY_LOCAL_MACHINE\Services\OBEX registry key.

Value Description

DLL: REG_SZ

Default Setting is OBEXSrVr.dll. The Dynamic-link library (DLL) file to be loaded.

Keep: REG_DWORD

Default Setting is 1. Specifies whether to postpone loading the DLL after initialization. When this DWORD value is zero (0), the DLL is loaded immediately.

Order: REG_DWORD

Default Setting is 9. The order in which the service is loaded. The service with the lowest DWORD value is loaded first.

Prefix: REG_SZ

Default Setting is OBX. Prefix of the DLL to be loaded.

Index: REG_DWORD

Default Setting is zero (0). Service index.

For more information about how these values are used when the system starts, see Services.exe Registry Settings.

OBEX Server Options

The following table shows the registry values for the HKEY_LOCAL_MACHINE\Software\Microsoft\Obex registry key.

Value Description

DebugOutputMask: REG_DWORD

Default Setting is zero (0). The mask of enabled debug zones. The following list shows the DWORD values you can use:

  • 0x00010000 to mask output errors
  • 0x00020000to mask output warnings
  • 0x00040000 to mask output packets
  • 0x00080000 to mask output protocols
  • 0x00100000 to mask output initialization information.
  • 0x00200000 to mask output maintenance work.

DebugOutputChannels: REG_DWORD

Default Setting is 4. The mask of OBEX debug output channels. DWORD.

protocols: REG_SZ

Default Setting is bth,irda.

To remove or add protocols, you can change this value. For example, if you want only IrDA, change the value to irda. Then, restart OBEX with the new settings by issuing IOCTL_SERVICE_REFRESH.

IsEnabled: REG_DWORD

Default Setting is zero (0). The status of the OBEX Server. This value can be either zero (0) (Disabled) or 1 (Enabled).

For information about how to disable Obex, see Server Support.

Obex Default Inbox

The following table shows the registry values for the HKEY_LOCAL_MACHINE\Software\Microsoft\Obex\Services\{00000000-0000-0000-0000-000000000000} registry key.

Value Description

BaseDir: REG_SZ

Default Setting is \My Document. The directory where the beamed file is located.

Server: REG_SZ

Default Setting is obexinbx.dll.

BluetoothSdpRecord: REG_HEX

A record sent to SDP for OBEX. Default Setting is:

hex:35,5f,09,00,01,35,03,19,11,05,09,00,04,35,11,35,\

03,19,01,00,35,05,19,00,03,08,0a,35,03,19,00,08,\

09,00,06,35,09,09,65,6e,09,00,6a,09,01,00,09,00,\

09,35,08,35,06,19,11,05,09,01,00,09,01,00,25,10,\

4f,42,45,58,20,4f,62,6a,65,63,74,20,50,75,73,68,\

09,03,03,35,0c,35,02,08,01,35,02,08,02,35,02,08,\

03

Transport Authenticate: REG_DWORD

This value requests transport authentication.

The following table shows the registry values for the HKEY_LOCAL_MACHINE\Software\Microsoft\Obex\Services\{00000000-0000-0000-0000-000000000000}\MimeTypes registry key.

Value Description

DefaultFile: REG_SZ

Default is vCard. A string that specifies the default file to send.

DLL: REG_SZ

A string that indicates the dll of the service header to load. After the DLL is loaded, getProcAddress is called for the ObexInboxClient.

Extension: REG_SZ

Default is .vcd. A string of file extensions for the MIME type.

Obex File Server

The following table shows the registry values for the HKEY_LOCAL_MACHINE\SOFTWARE\Microsoft\Obex\Services\{f9ec7bc4-953c-11d2-984e-525400dc9e09} registry key.

Note

By default, File Server is not supported on Windows Mobile. You can prevent FTP server from appearing in the list of supported services returned by an SDP query. To do so, set BluetoothSdpRecord and Server values as follows:

"BluetoothSdpRecord"=hex: 00
"Server"=""
Value Description

BaseDir: REG_SZ

Default Setting is \\Temp\\Ftp. The directory where the FTP Server puts files.

Server: REG_SZ

Default Setting is obexinbx.dll. Set this value to " ". This ensures that FTP server is not returned in an SDP query.

BluetoothSdpRecord: REG_HEX

A record sent to SDP for OBEX.

Default Setting is:

hex:35,41,09,00,01,35,03,19,11,06,09,00,04,35,11,35,\

03,19,01,00,35,05,19,00,03,08,0a,35,03,19,00,08,\

09,00,06,35,09,09,65,6e,09,00,6a,09,01,00,09,00,\

09,35,08,35,06,19,11,06,09,01,00,09,01,00,25,03,\

46,54,50

To prevent the FTP server from appearing in the list of supported services; set this value to hex: 00.

See Also

Other Resources

Object Exchange Protocol