Determining If the Specified Server Is a Front-End Server

Determining If the Specified Server Is a Front-End 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 determines if the specified server is a front-end server.

Visual Basic

'//////////////////////////////////////////////////////////////////////
' Function: isFrontEndServer()
' Purpose:  Determines if the specified server is a front-end server.
'
' Input:    szDomainName:               Domain of the Exchange organization
'           szOrganizationName:         Name of Exchange Organization
'           szAdministrativeGroupName:  Name of Administrative Group
'           szServerName:               Name of server to enumerate
'           szUserName:                 Admin Username
'           szUserPwd:                  Admin pwd
'           szUserList:                 List of users
'           szDirectoryServer:          Name of the Directory Server
'
' Output:   isFrontEndServer:           Contains Error code (if any)
'           isFrontEnd                  Answer to the question
'
' 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 isFrontEndServer(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 isFrontEnd As Boolean, _
                                 ByVal szDirectoryServer) As Integer


    Dim objLdap As IADsOpenDSObject
    Dim objContainer As IADs
    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 ldap connection string.

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

    ' Open up the directory with passed credentials.

    Set objLdap = GetObject("LDAP:")

    ' Get a container object from the connection string.

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

    isFrontEnd = CBool(objContainer.Get("serverRole"))

    isFrontEndServer = 0

    ' Clean up.
    Set objLdap = Nothing
    Set objContainer = Nothing

    Exit Function

    ' Error handling.
errhandler:

    Set objLdap = Nothing
    Set objContainer = Nothing
    isFrontEndServer = 1
    ' 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.