estrutura DOMAIN_CONTROLLER_INFOA (dsgetdc.h)

  • Artigo

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

Confira também

Estruturas de serviço de diretório

Dsgetdcname