estrutura DFS_INFO_105 (lmdfs.h)
Contém informações sobre uma raiz ou link do DFS, incluindo comentários, estado, tempo limite e comportamentos DFS especificados por sinalizadores de propriedade. Essa estrutura é usada apenas com a função NetDfsSetInfo .
Sintaxe
typedef struct _DFS_INFO_105 {
LPWSTR Comment;
DWORD State;
ULONG Timeout;
ULONG PropertyFlagMask;
ULONG PropertyFlags;
} DFS_INFO_105, *PDFS_INFO_105, *LPDFS_INFO_105;
Membros
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 o estado da raiz ou do link do DFS; o estado da raiz do namespace do DFS não pode ser alterado. Um sinalizador DFS_VOLUME_STATE é definido e um sinalizador DFS_VOLUME_FLAVOR está definido. Para obter um exemplo que descreve a interpretação desses sinalizadores, consulte a seção Comentários de DFS_INFO_2.
Padrão (0x00000000)
Mantenha o estado existente.
DFS_VOLUME_STATE_OK (0x00000001)
A raiz ou o link do DFS especificado está no estado normal.
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.
Timeout
Especifica o tempo limite, em segundos, da raiz ou do link do DFS.
PropertyFlagMask
Especifica um valor de máscara que indica quais sinalizadores são válidos para avaliação no campo PropertyFlags .
PropertyFlags
Bitfield, com cada bit responsável por uma propriedade específica aplicável a todo o namespace dfs, a raiz DFS ou um link dfs individual, dependendo da propriedade real. Qualquer combinação de bits é permitida, a menos que indicado o contrário.
DFS_PROPERTY_FLAG_INSITE_REFERRALS (0x00000001)
Resposta de referência de um servidor DFS para uma raiz do DFS ou link que contém apenas os destinos no mesmo site que o cliente que solicita a indicação. Os destinos nas duas classes de prioridade global são sempre retornados, independentemente da localização do site. Esse sinalizador se aplica a raízes dfs baseadas em 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, ele se aplica a um link individual. A configuração no link não substitui a configuração raiz.
DFS_PROPERTY_FLAG_ROOT_SCALABILITY (0x00000002)
Se esse sinalizador for definido, o servidor DFS sonda o controlador de domínio (DC) mais próximo em vez do controlador de domínio primário (PDC) para marcar para alterações de namespace do DFS para esse namespace. Qualquer modificação nos metadados do DFS pelo servidor DFS não é controlada por esse sinalizador, mas é enviada automaticamente ao PDC. Esse sinalizador se aplica a todo o namespace e é válido apenas para namespaces DFS baseados em domínio.
DFS_PROPERTY_FLAG_SITE_COSTING (0x00000004)
Defina esse sinalizador para habilitar o custo de sites do Active Directory de destinos. Os destinos retornados do servidor DFS para o cliente DFS solicitante são agrupados pelo custo entre sites em relação ao cliente DFS. Os grupos são ordenados em termos de aumento do custo do site com o primeiro grupo que consiste em destinos no mesmo site que o cliente. Os destinos dentro de cada grupo são ordenados aleatoriamente.
Se esse sinalizador não estiver habilitado, o retorno padrão será dois conjuntos: um conjunto de destinos no mesmo site que o cliente e um conjunto de todos os destinos restantes. Esse sinalizador se aplica a todo o namespace dfs e é válido para namespaces DFS baseados em domínio e autônomos.
As prioridades de destino podem influenciar ainda mais a ordenação de destino. 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)
Defina esse sinalizador para permitir que os clientes V4 DFS façam failback para um destino mais ideal (menor custo ou prioridade mais alta). Se esse sinalizador for definido na raiz do DFS, ele se aplicará a todos os links; caso contrário, ele se aplica a um link individual. Uma configuração de link individual não substituirá uma configuração raiz. A configuração de failback de destino é fornecida ao cliente DFS em uma resposta de indicação V4 pelo servidor DFS. Esse sinalizador se aplica a raízes dfs baseadas em domínio, raízes autônomas e links.
DFS_PROPERTY_FLAG_CLUSTER_ENABLED (0x00000010)
Escopo: somente raízes e links autônomos.
Se esse sinalizador estiver definido, a raiz do DFS será 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.
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
Priorização de destino do servidor DFS
Funções do DFS (Sistema de Arquivos Distribuídos)