estrutura DFS_INFO_8 (lmdfs.h)
Contém o nome, status, GUID, tempo limite, sinalizadores de propriedade, tamanho dos metadados, informações de destino do DFS e descritor de segurança de ponto de nova análise de link para uma raiz ou link. Essa estrutura é usada apenas com as funções NetDfsGetInfo e NetDfsEnum .
Sintaxe
typedef struct _DFS_INFO_8 {
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;
} DFS_INFO_8, *PDFS_INFO_8, *LPDFS_INFO_8;
Membros
EntryPath
Ponteiro para uma cadeia de caracteres Unicode terminada em nulo que especifica o caminho UNC de uma raiz ou link 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 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 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 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 de DFS_VOLUME_FLAVOR é 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 a raiz do DFS ou o estado do link desse membro. Para obter um exemplo que descreve a interpretação dos sinalizadores, consulte a seção Comentários do DFS_INFO_2.
DFS_VOLUME_STATE_OK (0x00000001)
O link ou raiz 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 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 do local do site.
DFS_PROPERTY_FLAG_ROOT_SCALABILITY (0x00000002)
Escopo: o namespace 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 dfs. Definir esse sinalizador fará com que o servidor DFS sondar o controlador de domínio mais próximo em vez das alterações de metadados do PDC para DFS para o namespace comum. Observe que as alterações feitas nos metadados ainda devem ocorrer no PDC, no entanto.
DFS_PROPERTY_FLAG_SITE_COSTING (0x00000004)
Escopo: o namespace dfs inteiro para namespaces DFS autônomos e baseados em domínio.
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 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 após o 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 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 somente 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 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 dfs. Esse campo é válido somente para links DFS.
SdLengthReserved
Esse membro é reservado para uso do sistema.
NumberOfStorages
Especifica o número de servidores de armazenamento para o volume que contém a raiz ou o link do DFS.
Requisitos
| 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) |