Registry Keys

The ValidCommunites registry key describes the communities that are accepted by the agent and the types of permission that they have:

HKEY_LOCAL_MACHINE\SYSTEM\CurrentControlSet\Services\SNMP\Parameters\ValidCommunities

The following table shows the registry settings for HKEY_LOCAL_MACHINE\SYSTEM\CurrentControlSet\Services|SNMP\Parameters\Valid Communities.

Registry key Type Value Default Description
Community1 DWORD Permission setting for Community 1: 8 = read/write, 4 = read only, and 1 = no access. None Sets the permission for a community
Community2 DWORD      

The following table shows an example of how to define the registry settings for HKEY_LOCAL_MACHINE\SYSTEM\CurrentControlSet\Services|SNMP\Parameters\Valid Communities.

Sample name Example
Public DWORD: 8
Assign the read/write value to public.
Community1 DWORD: 4
Assign the read-only value to Community1.
Community2 DWORD: 1
Disable accesses to Community2.

The RFC1156 registry key contains values that are used by the MIB-II extension agent to specify the value of some of its objects:

HKEY_LOCAL_MACHINE\SYSTEM\CurrentControlSet\Services\SNMP\RFC1156Agent

The following table shows the registry settings for HKEY_LOCAL_MACHINE\SYSTEM\CurrentControlSet\Services\SNMP\RFC1156Agent.

Registry key Type Value Default Description
sysContact String The name of your system contact

Example:

John Doe

N/A Contains the system contact for the SNMP agent.
sysLocation String The location of the computer on which the agent is running.

Example: 7/1234 - One Microsoft Way, Redmond, WA

N/A Contains a string that describes the location of the computer on which the agent is running.

The ExtensionAgents key describes the extension agents to load:

HKEY_LOCAL_MACHINE\SYSTEM\CurrentControlSet\Services\SNMP\Parameters\ExtensionAgents

The following table shows the registry settings for HKEY_LOCAL_MACHINE\SYSTEM\CurrentControlSet\Services\SNMP\Parameters\ExtensionAgents.

Registry key Type Value Default Description
Unique_# String Registry subkey; backslashes must be used in pairs (\\). N/A Contains the registry subkey from which the parameters for the extension agent can be read.

The following table shows an example of the registry settings for HKEY_LOCAL_MACHINE\SYSTEM\CurrentControlSet\Services\SNMP\Parameters\ExtensionAgents.

Example Registry key
1 SOFTWARE\\Microsoft\\MIBII\\CurrentVersion
2 SOFTWARE\\Microsoft\\HostMIB\\CurrentVersion
3 SOFTWARE\\MyCompany\\MyMIB\\CurrentVersion

HKEY_LOCAL_MACHINE\Subkey value from the preceding table

The following table shows the registry settings for your subagent key, as listed in the preceding key.

Registry key Type Value Default Description
Pathname String The name of your extension-agent DLL. Pathname is not required under Windows CE.

Example:

Mymib.dll

N/A Contains the name of the extension-agent DLL that the master agent should load.
Other parameters     N/A Place any other parameters here that your extension agent might want to read from the registry.

The EnableAuthenticationTraps registry key determines whether authentication traps will be generated when a request is received from a non-valid manager or community:

HKEY_LOCAL_MACHINE\SYSTEM\CurrentControlSet\Services\SNMP\Parameters\EnableAuthenticationTraps

The following table shows the registry settings for HKEY_LOCAL_MACHINE\SYSTEM\CurrentControlSet\Services\SNMP\Parameters\EnableAuthenticationTraps.

Registry key Type Value Default Description
Switch DWORD 1 enables authentication traps.

0 disables authentication traps.

Enabled This switches on or switches off the sending of authentication traps.

The TrapConfiguration registry key specifies the managers to which traps will be sent and the community that will be specified in the trap:

HKEY_LOCAL_MACHINE\SYSTEM\CurrentControlSet\Services\SNMP\Parameters\TrapConfiguration

The following table shows the registry settings for HKEY_LOCAL_MACHINE\SYSTEM\CurrentControlSet\Services\SNMP\Parameters\TrapConfiguration.

Registry key Type Value Default Description
Unique_# String A resolvable manager name or an IP address. *None The name of the manager within this community to which you want to send traps.

HKEY_LOCAL_MACHINE\SYSTEM\CurrentControlSet\Services\SNMP\Parameters\TrapConfiguration\public]

The following table shows an example of the registry settings for HKEY_LOCAL_MACHINE\SYSTEM\CurrentControlSet\Services\SNMP\Parameters\TrapConfiguration\ for a community that is specified as "public."

Example Value
1 machine1
2 123.12.23.111
3 machine2

[HKEY_LOCAL_MACHINE\SYSTEM\CurrentControlSet\Services\SNMP\Parameters\TrapConfiguration\mycommunity]

The following table shows the registry settings for KEY_LOCAL_MACHINE\SYSTEM\CurrentControlSet\Services\SNMP\Parameters\TrapConfiguration\ for a community that is specified as "mycommunity."

Example Value
1 machine3
2 machine4
3 122.222.111.1

The PermittedManagers key specifies the managers that are allowed to send requests to the agent. Note that if no managers are specified, requests will be accepted from any manager.

HKEY_LOCAL_MACHINE\SYSTEM\CurrentControlSet\Services\SNMP\Parameters\PermittedManagers

The following table shows the registry settings for HKEY_LOCAL_MACHINE\SYSTEM\CurrentControlSet\Services\SNMP\Parameters\PermittedManagers.

Registry key Type Value Default Description
Unique_# String Resolvable manager name or IP address.

Example:

machine1

111.222.123.231

mymachine

None The name of a manager that you want to be able to manage this entity.

HKEY_LOCAL_MACHINE\SYSTEM\CurrentControlSet\Services\SNMP\Parameters

The following table shows the registry settings for HKEY_LOCAL_MACHINE\SYSTEM\CurrentControlSet\Services\SNMP\Parameters.

Registry key Type Value Default Description
PDUBufferLength DWORD Size of the PDU buffer 1024 Buffer size for data transfers through the SNMP agent.

Note   When setting the value for this registry key, make sure not to set the size of the PDU buffer at a value that is too small. If the length of the PDU buffer is too small, the extension agent may not be able to fit responses into the minimum size.

HKEY_LOCAL_MACHINE\SYSTEM\CurrentControlSet\Services\SNMP\Parameters\TrapVersion

The following table shows the registry settings for HKEY_LOCAL_MACHINE\SYSTEM\CurrentControlSet\Services\SNMP\Parameters\TrapVersion.

Registry key Type Value Default Description
DefaultVersion DWORD Version of SNMP to be used for traps by default. 0 Values that are supported are 0 for SNMPv1 and 1 for SNMPv2c.
trap_destination DWORD Trap version to be used for this trap destination. 0 Computer name must be in the list of trap destinations.

 Last updated on Friday, April 02, 2004

© 1992-2000 Microsoft Corporation. All rights reserved.