estrutura DFS_INFO_5 (lmdfs.h)
Contém informações sobre uma raiz ou link do DFS (Sistema de Arquivos Distribuído). Essa estrutura contém o nome, status, GUID, tempo limite, propriedades namespace/root/link, tamanho dos metadados e número de destinos para a raiz ou link. Essa estrutura é usada apenas com as funções NetDfsEnum, NetDfsGetClientInfo e NetDfsGetInfo .
Para recuperar informações sobre os destinos do namespace do DFS, use DFS_INFO_6 em vez disso.
Sintaxe
typedef struct _DFS_INFO_5 {
LPWSTR EntryPath;
LPWSTR Comment;
DWORD State;
ULONG Timeout;
GUID Guid;
ULONG PropertyFlags;
ULONG MetadataSize;
DWORD NumberOfStorages;
} DFS_INFO_5, *PDFS_INFO_5, *LPDFS_INFO_5;
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. 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)
Somente os destinos no mesmo site que o cliente são retornados. Esse sinalizador é válido para raízes e links independentes e de domínio.
DFS_PROPERTY_FLAG_ROOT_SCALABILITY (0x00000002)
O controlador de domínio mais próximo é sondado em vez das alterações de namespace do PDC para DFS. Esse sinalizador só é válido para raízes de domínio.
DFS_PROPERTY_FLAG_SITE_COSTING (0x00000004)
O custo de sites do Active Directory de destinos está habilitado, agrupando destinos em conjuntos de aumento dos custos do site do cliente DFS para o destino. Cada conjunto tem destinos com o mesmo custo. Esse sinalizador só é válido para raízes autônomas e de domínio.
DFS_PROPERTY_FLAG_TARGET_FAILBACK (0x00000008)
O cliente DFS faz failback para um destino mais próximo disponível depois de fazer failover para um destino não ideal. Esse sinalizador é válido para raízes e links independentes e de domínio.
DFS_PROPERTY_FLAG_CLUSTER_ENABLED (0x00000010)
A raiz do DFS está clusterizado. 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 membro especifica o tamanho dos metadados armazenados no registro, incluindo os nomes de chave e nomes de valor, bem como os itens de dados específicos associados a eles.
Esse membro é válido apenas para raízes dfs.
NumberOfStorages
Especifica o número de destinos para a raiz ou link do DFS.
Comentários
Para recuperar informações sobre destinos e prioridades de destino, use a estrutura DFS_INFO_6 . DFS_INFO_5 é usado para especificar informações sobre um namespace do DFS sem informações de destino.
Requisitos
| Cliente mínimo com suporte | Windows Vista |
| Servidor mínimo com suporte | Windows Server 2008, Windows Server 2008 |
| Cabeçalho | lmdfs.h (inclua LmDfs.h, Lm.h) |
Confira também
Funções do DFS (Sistema de Arquivos Distribuídos)