Funzioni del servizio directory (AD DS)

Le funzioni del servizio directory forniscono un'utilità per l'individuazione di un controller di dominio (DC) in un dominio Windows NT o Windows 2000. L'architettura interagisce con client e server in tutte le versioni di Windows NT e Windows 2000. Le funzioni seguenti consentono agli sviluppatori di usare il controller di dominio e l'appartenenza al dominio nel servizio directory:

• DsAddressToSiteNames
• DsAddressToSiteNamesEx
• DsDeregisterDnsHostRecords
• DsEnumerateDomainTrusts
• DsGetDcClose
• Dsgetdcname
• DsGetDcNext
• DsGetDcOpen
• DsGetDcSiteCoverage
• DsGetForestTrustInformationW
• DsGetSiteName
• DsMergeForestTrustInformationW
• DsRoleFreeMemory
• DsRoleGetPrimaryDomainInformation
• DsValidateSubnetName

Il localizzatore dc, DsGetDcName, viene implementato dal servizio Netlogon. Ogni controller di dominio registra il nome DNS nel server DNS e il relativo nome NetBIOS usando un meccanismo specifico del trasporto, ad esempio, in WINS. Il localizzatore del controller di dominio cerca il nome, quindi invia un datagramma a o ping, il controller di dominio che ha registrato il nome. Per i nomi di dominio NetBIOS, il datagramma è un messaggio mailslot. Per i nomi di dominio DNS, il datagramma è una ricerca UDP LDAP. Ogni controller di dominio risponde a indicare che è attualmente operativo. Il primo controller di dominio a rispondere viene restituito al chiamante.

Il controller di dominio restituito viene memorizzato nella cache, in modo che i chiamanti successivi non debbano ripetere l'algoritmo precedente e incoraggiare tutti i chiamanti a usare lo stesso controller di dominio. Ciò garantisce che un singolo client abbia una visualizzazione coerente del contenuto del controller di dominio.

Quando si cerca un controller di dominio per nome di dominio DNS, il localizzatore del controller di dominio tenta di trovare un controller di dominio nel sito "più vicino". Ogni controller di dominio registra record DNS aggiuntivi che indicano il sito in cui si trova il controller di dominio e quali siti include il controller di dominio. Il localizzatore del controller di dominio cerca prima di cercare questo record DNS specifico del sito prima di cercare il record DNS non specifico del sito, quindi preferire un controller di dominio in tale sito. Quando il localizzatore del controller di dominio invia un datagramma al controller di dominio, il controller di dominio cerca l'indirizzo IP del client nel contenitore Configuration/Sites/Subnet del DS per trovare un oggetto subnet. La proprietà siteObject dell'oggetto subnet definisce il nome del sito che contiene il client. Il controller di dominio risponde al ping con il nome del sito che contiene il client, insieme a un indicatore che indica se il controller di dominio copre tale sito. Se il controller di dominio non include tale sito e il localizzatore del controller di dominio non ha ancora tentato di trovare un controller di dominio in tale sito, il localizzatore del controller di dominio tenta di trovare un controller di dominio nel sito.

Per trovare il nome del sito contenente il client, usare la funzione DsGetSiteName. I nomi degli oggetti nel contenitore Configuration/Sites/Subnet devono essere nomi di subnet validi. La funzione DsValidateSubnetName indica se un nome di subnet specificato è valido.