estrutura DFS_INFO_9 (lmdfs.h)
Contém o nome, status, GUID, tempo limite, sinalizadores de propriedade, tamanho dos metadados, informações de destino do DFS, descritor de segurança do ponto de nova análise de link e uma lista de destinos dfs para uma raiz ou link. Essa estrutura é usada apenas com as funções NetDfsGetInfo e NetDfsEnum .
Sintaxe
typedef struct _DFS_INFO_9 {
LPWSTR EntryPath;
LPWSTR Comment;
DWORD State;
ULONG Timeout;
GUID Guid;
ULONG PropertyFlags;
ULONG MetadataSize;
ULONG SecurityDescriptorLength;
#if ...
PUCHAR pSecurityDescriptor;
ULONG SdLengthReserved;
#else
PSECURITY_DESCRIPTOR pSecurityDescriptor;
#endif
DWORD NumberOfStorages;
#if ...
LPDFS_STORAGE_INFO_1 Storage;
#else
LPDFS_STORAGE_INFO_1 Storage;
#endif
} DFS_INFO_9, *PDFS_INFO_9, *LPDFS_INFO_9;
Membros
EntryPath
Ponteiro para uma cadeia de caracteres Unicode terminada em nulo que especifica o caminho UNC (Convenção de Nomenclatura Universal) de uma raiz ou link do DFS.
Para um link, a cadeia de caracteres pode estar em uma das duas formas. O primeiro formulário é o seguinte:
\\ Servername\DfsName\link_path
em que ServerName é o nome do servidor de destino raiz que hospeda o namespace dfs autônomo; DfsName é o nome do namespace do DFS; e link_path é um link do DFS.
O segundo formulário é o seguinte:
\\ Domainname\DomDfsname\link_path
em que DomainName é o nome do domínio que hospeda o namespace DFS baseado em domínio; DomDfsname é o nome do namespace do DFS; e link_path é um link do DFS.
Para uma raiz, a cadeia de caracteres pode estar em uma das duas formas:
\\ Servername\DfsName
ou
\\ Domainname\DomDfsname
em que os valores dos nomes são os mesmos descritos anteriormente.
Comment
Ponteiro para uma cadeia de caracteres Unicode terminada em nulo que contém um comentário associado à raiz ou ao link do DFS.
State
Especifica um conjunto de sinalizadores de bits que descrevem a raiz ou o link do DFS. Um sinalizador DFS_VOLUME_STATE é definido e um sinalizador DFS_VOLUME_FLAVOR está definido. A máscara de bits DFS_VOLUME_FLAVORS (0x00000300) deve ser usada para extrair o tipo de namespace DFS e a máscara de bits DFS_VOLUME_STATES (0x0000000F) deve ser usada para extrair o estado de raiz ou link do DFS desse membro. Para obter um exemplo que descreve a interpretação dos sinalizadores, consulte a seção Comentários de DFS_INFO_2.
DFS_VOLUME_STATE_OK (0x00000001)
A raiz ou o link do DFS especificado está no estado normal.
DFS_VOLUME_STATE_INCONSISTENT (0x00000002)
O banco de dados DFS interno é inconsistente com a raiz ou o link do DFS especificado. As tentativas de reparar a inconsistência falharam.
DFS_VOLUME_STATE_OFFLINE (0x00000003)
O link ou raiz do DFS especificado está offline ou indisponível.
DFS_VOLUME_STATE_ONLINE (0x00000004)
A raiz ou o link do DFS especificado está disponível.
DFS_VOLUME_FLAVOR_STANDALONE (0x00000100)
O sistema define esse sinalizador se a raiz estiver associada a um namespace dfs autônomo.
DFS_VOLUME_FLAVOR_AD_BLOB (0x00000200)
O sistema define esse sinalizador se a raiz estiver associada a um namespace DFS baseado em domínio.
Timeout
Especifica o tempo limite, em segundos, da raiz ou do link do DFS.
Guid
Especifica o GUID da raiz ou do link do DFS.
PropertyFlags
Especifica um conjunto de sinalizadores que descrevem propriedades específicas de um namespace, raiz ou link do DFS.
DFS_PROPERTY_FLAG_INSITE_REFERRALS (0x00000001)
Escopo: raízes de domínio, raízes autônomas e links. Se esse sinalizador for definido na raiz do DFS, ele se aplicará a todos os links; caso contrário, o valor desse sinalizador é considerado para cada link individual.
Quando esse sinalizador é definido, uma resposta de indicação dfs de um servidor DFS para uma raiz dfs ou link com a opção "INSITE" habilitada contém apenas os destinos que estão no mesmo site que o cliente DFS que solicita a indicação. Os destinos nas duas classes de prioridade global sempre são retornados, independentemente da localização do site.
DFS_PROPERTY_FLAG_ROOT_SCALABILITY (0x00000002)
Escopo: o namespace do DFS inteiro somente para um namespace dfs baseado em domínio.
Por padrão, um servidor de destino raiz do DFS sonda o PDS para detectar alterações nos metadados do DFS. Para evitar a carga pesada do servidor no PDC, a escalabilidade raiz pode ser habilitada para o namespace do DFS. Definir esse sinalizador fará com que o servidor DFS pesquise o controlador de domínio mais próximo em vez das alterações de metadados do PDC para DFS para o namespace comum. No entanto, observe que todas as alterações feitas nos metadados ainda devem ocorrer no PDC.
DFS_PROPERTY_FLAG_SITE_COSTING (0x00000004)
Escopo: o namespace dfs inteiro para namespaces DFS baseados em domínio e autônomos.
Por padrão, os destinos retornados em uma resposta de indicação de um servidor DFS para um cliente DFS para uma raiz ou link do DFS consistem em dois grupos: destinos no mesmo site que o cliente e destinos fora do site.
Se o custo do site estiver habilitado para o Active Directory, a resposta poderá ter mais de dois grupos, com cada grupo contendo destinos com o mesmo custo de site para o cliente DFS específico solicitando a indicação. Os grupos são ordenados aumentando o custo do site. Para obter mais informações sobre como o custo do site é usado para priorizar destinos, consulte Priorização de destino do servidor DFS.
DFS_PROPERTY_FLAG_TARGET_FAILBACK (0x00000008)
Escopo: raízes dfs baseadas em domínio, raízes dfs autônomas e links dfs. Se esse sinalizador for definido na raiz do DFS, ele se aplicará a todos os links; caso contrário, o valor desse sinalizador é considerado para cada link individual.
Quando esse sinalizador é definido, o failback de destino ideal é habilitado para clientes DFS V4, permitindo que eles façam failback para um destino ideal depois de fazer failover para um não ideal. A configuração de failback de destino é fornecida ao cliente DFS em uma resposta de indicação V4 por um servidor DFS.
DFS_PROPERTY_FLAG_CLUSTER_ENABLED (0x00000010)
Escopo: somente raízes e links dfs autônomos.
A raiz do DFS é clusterizado para fornecer alta disponibilidade para failover de armazenamento. Esse sinalizador não pode ser definido usando a função NetDfsSetInfo .
DFS_PROPERTY_FLAG_ABDE (0x00000020)
Escopo: raízes dfs baseadas em domínio e raízes dfs autônomas.
Quando esse sinalizador é definido, Access-Based suporte ao modo ABDE (Enumeração de Diretório) é habilitado em todo o compartilhamento de destino raiz dfs do namespace DFS. Esse sinalizador é válido apenas para namespaces dfs para os quais o sinalizador de funcionalidade DFS_NAMESPACE_CAPABILITY_ABDE está definido. Para obter mais informações, consulte DFS_INFO_50 e DFS_SUPPORTED_NAMESPACE_VERSION_INFO.
O sinalizador DFS_PROPERTY_FLAG_ABDE é válido apenas na raiz do namespace do DFS e não em destinos raiz, links ou destinos de link. Esse sinalizador deve ser habilitado para associar um descritor de segurança a um link do DFS.
MetadataSize
Para namespaces DFS baseados em domínio, esse membro especifica o tamanho do blob de dados do Active Directory correspondente, em bytes. Para namespaces dfs autônomos, esse campo especifica o tamanho dos metadados armazenados no registro, incluindo os nomes de chave e os nomes de valor, além dos itens de dados específicos associados a eles.
Esse campo é válido apenas para raízes dfs.
SecurityDescriptorLength
pSecurityDescriptor
Ponteiro para uma estrutura SECURITY_DESCRIPTOR que especifica um descritor de segurança auto-relativo a ser associado ao ponto de nova análise do link do DFS. Esse campo é válido apenas para links dfs.
SdLengthReserved
Esse membro é reservado para uso do sistema.
NumberOfStorages
Especifica o número de destinos para a raiz ou link do DFS. Esses destinos estão contidos no membro armazenamento dessa estrutura.
Storage
Especifica uma matriz de estruturas de DFS_STORAGE_INFO_1 que contêm as informações de destino do DFS.
Requisitos
| Requisito | Valor |
|---|---|
| Cliente mínimo com suporte | Windows Vista com SP1 |
| Servidor mínimo com suporte | Windows Server 2008 |
| Cabeçalho | lmdfs.h (inclua LmDfs.h, Lm.h) |