Platform SDK: Active Directory, ADSI, and Directory Services

Creating an External Referral

If you create an external crossRef and a domain controller uses it to generate a referral (see the previous section for situations where this can occur), the crossRef provides the two key pieces of information in the following properties:

dnsRoot
Specifies the server or domain that can serve information from the naming context specified in nCName.
nCName
Specifies the distinguished name for the domain, schema, or configuration container rooted at the server or domain specified by dnsRoot.

For example, if the server with DNS address of serv1.northwest.Microsoft.com serves the naming context rooted at CN=MyContainer,OU=MyDOM,O=Microsoft, you would set the dnsRoot to that server's DNS address and the nCName to the distinguished name of the domain, schema, or configuration container.