OBEX Registry Settings (Compact 2013)
3/26/2014
The registry stores information that is required to configure the system for applications and hardware devices. The registry also contains information that the 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 Object Exchange (OBEX) Protocol server extensions. The registry key is HKEY_LOCAL_MACHINE\Software\Microsoft\OBEX\Services. The key can include one of the following subkeys:
- 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 timeout value, in ms, after which a service extension that has no active connections is unloaded. |
ConnectionTimeout: REG_DWORD |
Specifies the timeout value, in ms, after which a physical connection that has no activity is closed. |
MaintPeriod: REG_DWORD |
Specifies the timeout value, in ms. This refers to how frequently 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. |
Bluetooth 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 Servicesd.exe during device start. 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 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 that has 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 Windows Embedded Compact topic Servicesd.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 that you can use:
|
DebugOutputChannels: REG_DWORD |
Default Setting is 4. The mask of OBEX debug output channels. DWORD. |
protocols: REG_SZ |
Default Setting is bth. To remove or add protocols, you can change this value. 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). |
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 Documents\\DefaultInbox. The directory where the inbox server puts files. |
DisableUI: REG_DWORD |
Default DWORD value is 0. When this value is 1, all UI prompts are disabled, except for the upload and overwrite prompts. (Upload and overwrite prompts can be disabled by using the PromptBeforeUpload and PromptForOverwrite registry settings.) |
Server: REG_SZ |
Default Setting is obexinbx.dll. |
BluetoothSdpRecord: REG_HEX |
A record sent to SDP for OBEX. Default Setting is as follows: 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 |
PromptBeforeUpload: REG_DWORD |
Default DWORD value is 1. When this value is 1, the Server prompts the user to accept the file. If this value is zero (0), this security check is disabled. |
PromptForOverwrite: REG_DWORD |
Default DWORD value is 1. When this value is 1, the Server prompts the user to overwrite a file. If this value is zero (0), this security check is disabled. |
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 name 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.**
Value |
Description |
|---|---|
BaseDir: REG_SZ |
Default Setting is \\Temp\\Ftp. The directory where the FTP Server puts files. |
Server: REG_SZ |
Default Setting is obexfile.dll. The OBEX file server DLL. |
CanWrite |
Default Setting is zero (0). Specifies whether the file server allows read/write permission. This value is zero (0) for read-only access. When the value is any value other than zero (0), the file server allows for read and write access. |
BluetoothSdpRecord: REG_HEX |
A record sent to SDP for OBEX. Default Setting is as follows: 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 |
Password: REG_SZ |
The password; which is a string in nonencrypted text. |
Authenticate: REG_DWORD |
This value is a DWORD. If this value is zero (0), no authentication is required. |
Transport Authenticate: REG_DWORD |
This value is a DWORD. This value requests transport authentication. |