estrutura DFS_INFO_107 (lmdfs.h)
Contém informações sobre uma raiz ou link do DFS, incluindo o comentário, o estado, o tempo limite, os sinalizadores de propriedade e o descritor de segurança do ponto de nova análise de link. Essa estrutura é usada apenas com as funções NetDfsGetInfo e NetDfsSetInfo .
Sintaxe
typedef struct _DFS_INFO_107 {
LPWSTR Comment;
DWORD State;
ULONG Timeout;
ULONG PropertyFlagMask;
ULONG PropertyFlags;
ULONG SecurityDescriptorLength;
#if ...
PUCHAR pSecurityDescriptor;
ULONG SdLengthReserved;
#else
PSECURITY_DESCRIPTOR pSecurityDescriptor;
#endif
} DFS_INFO_107, *PDFS_INFO_107, *LPDFS_INFO_107;
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 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.
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 sempre são retornados, independentemente da localização do site. Esse sinalizador se aplica a 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, 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 ao PDC. Esse sinalizador é válido para todo o namespace e se aplica somente a 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 é válido para todo o namespace do DFS e se aplica a 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 baseadas em domínio, raízes autônomas e links.
DFS_PROPERTY_FLAG_CLUSTER_ENABLED (0x00000010)
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 e se aplica apenas a raízes e links dfs autônomos.
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.
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.
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) |