Getting the Next Available Entry ID for a Server

Getting the Next Available Entry ID for a Server

This content is no longer actively maintained. It is provided as is, for anyone who may still be using these technologies, with no warranties or claims of accuracy with regard to the most recent product version or service release.

The following example gets the next available entry ID for the specified server.

Visual Basic

'//////////////////////////////////////////////////////////////////////
' Function: getNextAvailableEntryID()
' Purpose:  Gets the next available entry ID for the specified server.
'
' Input:    szDomainName:               Domain of the Exchange organization
'           szOrganizationName:         Name of Exchange Organization
'           szAdministrativeGroupName:  Name of Administrative Group
'           szServerName:               Name of server to use
'           szUserName:                 Admin Username
'           szUserPwd:                  Admin pwd
'           szDirectoryServer:          Name of the Directory Server
'
' Output:   getNextAvailableEntryID:    Contains Error code (if any)
'           szEntryid                   Next available ID
'
' Note:  In order for this example to function correctly, it may be necessary to include
' references to the following libraries: Active DS Type Library, Microsoft CDO for
' Exchange Management Library, Microsoft Cluster Service Automation Classes,
' Microsoft CDO for Windows 2000 Library.
'//////////////////////////////////////////////////////////////////////
Public Function getNextAvailableEntryID(ByVal szDomainName As String, _
                                        ByVal szOrganizationName As String, _
                                        ByVal szAdministrativeGroupName As String, _
                                        ByVal szServerName As String, _
                                        ByVal szUserName As String, _
                                        ByVal szUserPwd As String, _
                                        ByRef szEntryID As String, _
                                        ByVal szDirectoryServer) As Integer
    Dim objLdap As IADsOpenDSObject
    Dim objHosting As IADsContainer
    Dim objObject As IADs
    Dim iEntryIDNum As Integer
    Dim szConnString As String
    Dim szaDomTokens() As String
    Dim szDomainDN As String

    On Error GoTo errhandler

    ' Put the domain name into an ldap string.
    szaDomTokens = Split(szDomainName, ".", -1, 1)
    szDomainDN = Join(szaDomTokens, ",dc=")
    szDomainDN = "dc=" & szDomainDN

    ' Build up the connection string.

    szConnString = "LDAP://" + szDirectoryServer + _
                   "/cn=http,cn=protocols,cn=" + szServerName + _
                   ",cn=servers,cn=" + szAdministrativeGroupName + _
                   ",cn=Administrative Groups,cn=" + szOrganizationName + _
                   ",cn=Microsoft Exchange,cn=services,cn=configuration," + _
                   szDomainDN


    ' Open up the directory with the passed credentials (preferably the admin).

    Set objLdap = GetObject("LDAP:")

    ' Get a container object from the connection string.

    Set objHosting = objLdap.OpenDSObject(szConnString, _
                                          szUserName, _
                                          szUserPwd, _
                                          ADS_SECURE_AUTHENTICATION)

    ' Enumerate though each http server installed and get the highest entry id.
    ' Start out at entry ID 100 because that is what the Exchange System Manager does.

    iEntryIDNum = 100

    objHosting.filter = Array("protocolCfgHTTPServer")

    For Each objObject In objHosting
        If iEntryIDNum <= Int(Val(Mid(objObject.Name, 4))) Then
            iEntryIDNum = Int(Val(Mid(objObject.Name, 4))) + 1
        End If
    Next

    szEntryID = Str(iEntryIDNum)

    getNextAvailableEntryID = 0

    ' Clean up.
    Set objLdap = Nothing
    Set objHosting = Nothing
    Set objObject = Nothing
    Exit Function

    'Error handling.
errhandler:

    szEntryID = "Couldn't do anything."
    getNextAvailableEntryID = 1
    Set objLdap = Nothing
    Set objHosting = Nothing
    Set objObject = Nothing
    ' Implement error logging here.
    Exit Function

End Function

Send us your feedback about the Microsoft Exchange Server 2003 SDK.

Build: June 2007 (2007.618.1)

© 2003-2006 Microsoft Corporation. All rights reserved. Terms of use.