estrutura DOMAIN_CONTROLLER_INFOA (dsgetdc.h)
A estrutura DOMAIN_CONTROLLER_INFO é usada com a função DsGetDcName para receber dados sobre um controlador de domínio.
Sintaxe
typedef struct _DOMAIN_CONTROLLER_INFOA {
LPSTR DomainControllerName;
LPSTR DomainControllerAddress;
ULONG DomainControllerAddressType;
GUID DomainGuid;
LPSTR DomainName;
LPSTR DnsForestName;
ULONG Flags;
LPSTR DcSiteName;
LPSTR ClientSiteName;
} DOMAIN_CONTROLLER_INFOA, *PDOMAIN_CONTROLLER_INFOA;
Membros
DomainControllerName
Ponteiro para uma cadeia de caracteres terminada em nulo que especifica o nome do computador do controlador de domínio descoberto. O nome do computador retornado é prefixado com "\". O nome de estilo DNS, por exemplo, "\phoenix.fabrikam.com", será retornado, se disponível. Se o nome de estilo DNS não estiver disponível, o nome de estilo simples (por exemplo, "\phoenix") será retornado. Este exemplo se aplicaria se o domínio for um domínio Windows NT 4.0 ou se o domínio não der suporte à família de protocolos IP.
DomainControllerAddress
Ponteiro para uma cadeia de caracteres terminada em nulo que especifica o endereço do controlador de domínio descoberto. O endereço é prefixado com "\". Essa cadeia de caracteres é um dos tipos definidos pelo membro DomainControllerAddressType .
DomainControllerAddressType
Indica o tipo de cadeia de caracteres contido no membro DomainControllerAddress . Esse pode ser um dos valores a seguir.
DS_INET_ADDRESS
O endereço é um endereço IP de cadeia de caracteres (por exemplo, "\157.55.94.74") do controlador de domínio.
DS_NETBIOS_ADDRESS
O endereço é um nome NetBIOS, por exemplo, "\phoenix", do controlador de domínio.
DomainGuid
O GUID do domínio. Esse membro será zero se o controlador de domínio não tiver um GUID de Domínio; por exemplo, o controlador de domínio não é um controlador de domínio do Windows 2000.
DomainName
Ponteiro para uma cadeia de caracteres terminada em nulo que especifica o nome do domínio. O nome de estilo DNS, por exemplo, "fabrikam.com", será retornado se disponível. Caso contrário, o nome de estilo simples, por exemplo, "fabrikam", será retornado. Esse nome poderá ser diferente do nome de domínio solicitado se o domínio tiver sido renomeado.
DnsForestName
Ponteiro para uma cadeia de caracteres terminada em nulo que especifica o nome do domínio na raiz da árvore DS. O nome de estilo DNS, por exemplo, "fabrikam.com", será retornado se disponível. Caso contrário, o nome de estilo simples, por exemplo, "fabrikam" será retornado.
Flags
Contém um conjunto de sinalizadores que descrevem o controlador de domínio. Isso pode ser zero ou uma combinação de um ou mais dos valores a seguir.
DS_DNS_CONTROLLER_FLAG
O membro DomainControllerName está no formato DNS.
DS_DNS_DOMAIN_FLAG
O membro DomainName está no formato DNS.
DS_DNS_FOREST_FLAG
O membro DnsForestName está no formato DNS.
DS_CLOSEST_FLAG
O controlador de domínio está no mesmo site que o cliente.
DS_DS_FLAG
O controlador de domínio é um servidor de serviço de diretório para o domínio.
DS_FULL_SECRET_DOMAIN_6_FLAG
O controlador de domínio é um controlador de domínio gravável do Windows 2008 ou posterior.
DS_GOOD_TIMESERV_FLAG
O controlador de domínio está executando um Serviço de Horário do Windows confiável para o domínio.
DS_GC_FLAG
O controlador de domínio é um servidor de catálogo global para a floresta especificada por DnsForestName.
DS_KDC_FLAG
O controlador de domínio é um Centro de Distribuição de Chaves Kerberos para o domínio.
DS_LDAP_FLAG
O servidor é um servidor LDAP.
DS_NDNC_FLAG
O Nome de Domínio é um contexto de nomenclatura de aplicativo (não domínio).
DS_PDC_FLAG
O controlador de domínio é o controlador de domínio primário do domínio.
DS_SELECT_SECRET_DOMAIN_6_FLAG
O controlador de domínio é um controlador de domínio somente leitura do Windows 2008 ou posterior.
DS_TIMESERV_FLAG
O controlador de domínio está executando o Serviço de Horário do Windows para o domínio.
DS_WRITABLE_FLAG
O controlador de domínio hospeda um serviço de diretório gravável (ou SAM).
DcSiteName
Ponteiro para uma cadeia de caracteres terminada em nulo que especifica o nome do site em que o controlador de domínio está localizado. Esse membro poderá ser NULL se o controlador de domínio não estiver em um site; por exemplo, o controlador de domínio é um controlador de domínio Windows NT 4.0.
ClientSiteName
Ponteiro para uma cadeia de caracteres terminada em nulo que especifica o nome do site ao qual o computador pertence. O computador é especificado no parâmetro ComputerName passado para DsGetDcName. Esse membro poderá ser NULL se o site que contém o computador não puder ser encontrado; por exemplo, se o administrador do DS não tiver associado a sub-rede em que o computador está com um site válido.
Comentários
Observação
O cabeçalho dsgetdc.h define DOMAIN_CONTROLLER_INFO como um alias que seleciona automaticamente a versão ANSI ou Unicode dessa função com base na definição da constante de pré-processador UNICODE. Misturar o uso do alias neutro de codificação com código que não seja neutro em codificação pode levar a incompatibilidades que resultam em erros de compilação ou de runtime. Para obter mais informações, consulte Convenções para protótipos de função.
Requisitos
| Requisito | Valor |
|---|---|
| Cliente mínimo com suporte | Windows Vista |
| Servidor mínimo com suporte | Windows Server 2008 |
| Cabeçalho | dsgetdc.h |