estrutura DS_DOMAIN_CONTROLLER_INFO_3A (ntdsapi.h)

Artigo
11/20/2024

A estrutura DS_DOMAIN_CONTROLLER_INFO_3 contém dados sobre um controlador de domínio. Essa estrutura é retornada pela função DsGetDomainControllerInfo.

Sintaxe

typedef struct {
#if ...
  CHAR  *NetbiosName;
#if ...
  CHAR  *DnsHostName;
#if ...
  CHAR  *SiteName;
#if ...
  CHAR  *SiteObjectName;
#if ...
  CHAR  *ComputerObjectName;
#if ...
  CHAR  *ServerObjectName;
#if ...
  CHAR  *NtdsDsaObjectName;
#else
  LPSTR NetbiosName;
#endif
#else
  LPSTR DnsHostName;
#endif
#else
  LPSTR SiteName;
#endif
#else
  LPSTR SiteObjectName;
#endif
#else
  LPSTR ComputerObjectName;
#endif
#else
  LPSTR ServerObjectName;
#endif
#else
  LPSTR NtdsDsaObjectName;
#endif
  BOOL  fIsPdc;
  BOOL  fDsEnabled;
  BOOL  fIsGc;
  BOOL  fIsRodc;
  GUID  SiteObjectGuid;
  GUID  ComputerObjectGuid;
  GUID  ServerObjectGuid;
  GUID  NtdsDsaObjectGuid;
} DS_DOMAIN_CONTROLLER_INFO_3A, *PDS_DOMAIN_CONTROLLER_INFO_3A;

Membros

NetbiosName

Ponteiro para uma cadeia de caracteres terminada em nulo que especifica o nome NetBIOS do controlador de domínio.

DnsHostName

Ponteiro para uma cadeia de caracteres terminada em nulo que especifica o nome do host DNS do controlador de domínio.

SiteName

Ponteiro para uma cadeia de caracteres terminada em nulo que especifica o site ao qual o controlador de domínio pertence.

SiteObjectName

Ponteiro para uma cadeia de caracteres terminada em nulo que especifica o nome do objeto do site no controlador de domínio.

ComputerObjectName

Ponteiro para uma cadeia de caracteres terminada em nulo que especifica o nome do objeto de computador no controlador de domínio.

ServerObjectName

Ponteiro para uma cadeia de caracteres terminada em nulo que especifica o nome do objeto de servidor no controlador de domínio.

NtdsDsaObjectName

Ponteiro para uma cadeia de caracteres terminada em nulo que especifica o nome do objeto DSA NTDS no controlador de domínio.

fIsPdc

Um valor booliano que indica se esse controlador de domínio é ou não o controlador de domínio primário. Se esse valor for VERDADEIRO, o controlador de domínio será o controlador de domínio primário; caso contrário, o controlador de domínio não é o controlador de domínio primário.

fDsEnabled

Um valor booliano que indica se o controlador de domínio está habilitado ou não. Se esse valor for TRUE, o controlador de domínio estará habilitado; caso contrário, ele não está habilitado.

fIsGc

Um valor booliano que indica se o controlador de domínio é ou não um servidor de catálogo global. Se esse valor for VERDADEIRO, o controlador de domínio será um servidor de catálogo global; caso contrário, não é um servidor de catálogo global.

fIsRodc

Um valor booliano que indica se o controlador de domínio é um controlador de domínio somente leitura. Se esse valor for VERDADEIRO, o controlador de domínio será um controlador de domínio somente leitura; caso contrário, não é um controlador de domínio somente leitura.

SiteObjectGuid

Contém o GUID para o objeto do site no controlador de domínio.

ComputerObjectGuid

Contém o GUID para o objeto de computador no controlador de domínio.

ServerObjectGuid

Contém o GUID para o objeto de servidor no controlador de domínio.

NtdsDsaObjectGuid

Contém o GUID para o objeto DSA do NTDS no controlador de domínio.

Observações

A função DsGetDomainControllerInfo pode retornar versões diferentes dessa estrutura. Para obter mais informações e uma lista das versões com suporte no momento, consulte o parâmetro InfoLevel de DsGetDomainControllerInfo.

Nota

O cabeçalho ntdsapi.h define DS_DOMAIN_CONTROLLER_INFO_3 como um alias que seleciona automaticamente a versão ANSI ou Unicode dessa função com base na definição da constante do pré-processador UNICODE. A combinação do uso do alias neutro de codificação com código que não é neutro em codificação pode levar a incompatibilidades que resultam em erros de compilação ou de runtime. Para obter mais informações, consulte Conventions for Function Prototypes.

Requisitos

Requisito	Valor
de cliente com suporte mínimo	Windows Vista
servidor com suporte mínimo	Windows Server 2008
cabeçalho	ntdsapi.h

Consulte também

estruturas de gerenciamento de replicação e controlador de domínio

DsGetDomainControllerInfo

Compartilhar via