Personal Area Network (PAN) Profile Registry Settings
Other versions of this page are also available for the following:
.gif "A hyphen indicates that the information in this topic is not relevant for this platform, or that the platform does not support the API that is listed.")
.gif "A checkmark indicates that the information in this topic is relevant for this platform, and that any API listed is also supported on this platform.")
8/28/2008
You can configure the PAN profile through the registry.
Note
The default registry values vary depending on which Catalog items are included in your OS design. For more information, see Default Registry Settings.
Global registry settings for the PAN profile are located under the HKEY_LOCAL_MACHINE\Software\Microsoft\Bluetooth\pan key.
The following table shows the named values for the pan registry key:
| Value : type | Description |
|---|---|
Authenticate : REG_DWORD |
Determines whether the connection is authenticated.
This setting is optional. .gif "Aa916487.security(en-us,MSDN.10).gif") Security Note:
Setting this value to 0 disables authentication. This may result in potential security risks.
|
Encrypt : REG_DWORD |
Determines whether the connection is encrypted.
This setting is optional. Security Note:
Setting this value to 0 disables encryption. This may result in potential security risks.
|
InquiryLength : REG_DWORD |
Specifies the length of the Bluetooth inquiry within the range of 1 to 255. Default value is 8. |
MediaDelay : REG_DWORD |
Specifies the total length of time, in milliseconds, between two Bluetooth inquiries. Default value is 300000 milliseconds (5 minutes). Minimum value is 30000 milliseconds (30 seconds). |
ActivateOnBoot : REG_DWORD |
Determines whether Bluetooth PAN is automatically activated when the device starts up. By default, Bluetooth PAN is not automatically activated.
|
Additional registry settings for configuring the PAN parameters are located under the HKEY_LOCAL_MACHINE\Comm\BTPAN1\Parms.
The following table shows the named values for the Parms registry key:
| Value : type | Description |
|---|---|
Accept Connections : REG_DWORD |
Determines whether new connections are allowed for PANU and Group Ad-hoc Network (GN) roles.
|
AdapterType : REG_SZ |
Specifies the type of adapters. Possible string values are:
|
ConnectionTimeout : REG_DWORD |
Specifies the total length of time, in milliseconds, that the device waits for a connection to complete. If the specified time elapses before connection completes, the connection is closed. The value can be set in the range of 1000 to 30000 milliseconds. |
Description :REG_SZ |
Specifies the service description to use in SDP records. |
FriendlyName : REG_SZ |
Specifies the friendly name of the service to use in Service Discovery Protocol (SDP) records. |
MaxConnections : REG_DWORD |
Specifies the maximum number of simultaneous connections for GN and Network Access Point (NAP) roles. |
SDP : REG_BINARY |
Specifies a BLOB that contains the SDP record for the service. If this is not provided, then the record is implicitly built. |
ServiceId : REG_SZ |
Specifies the global service identifier as a standard GUID string. |
You can also add the network associations for the PAN profile. The following code shows the registry values that are created for every network.
[HKEY_LOCAL_MACHINE\Comm\BTPAN1\Associations\device1]
"Address"=hex:00,00,00,00,00,00
"ServiceId"="{00001115-0000-1000-8000-00805f9b34fb}"
"SSID"="FriendlyDevice"
"Priority"=dword:1
You can configure the HKEY_LOCAL_MACHINE\Software\Microsoft\Bluetooth\l2cap registry key. For the Network Access Point role, configure this key to enable the Bluetooth stack to request a role-switch with the peer device.
The following table shows the named values to set for the l2cap registry key.
| Value : type | Description |
|---|---|
NoRoleSwitch: REG_DWORD |
0 - Enables the stack to request a role-switch with the peer device for an incoming connection. 1 - Disables role switching. Default. |
See Also
Concepts
Personal Area Networking (PAN) Profile
Bluetooth Profiles