estrutura DFS_INFO_2 (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 e o número de destinos dfs para a raiz ou link. Essa estrutura é usada apenas com as funções NetDfsEnum, NetDfsGetClientInfo e NetDfsGetInfo e o código de controle FSCTL_DFS_GET_PKT_ENTRY_STATE .
Sintaxe
typedef struct _DFS_INFO_2 {
LPWSTR EntryPath;
LPWSTR Comment;
DWORD State;
DWORD NumberOfStorages;
} DFS_INFO_2, *PDFS_INFO_2, *LPDFS_INFO_2;
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 a seguir.
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.
NumberOfStorages
Especifica o número de destinos dfs.
Comentários
As funções DFS usam a estrutura DFS_INFO_2 para recuperar informações sobre uma raiz ou link do DFS.
Veja a seguir um exemplo que descreve a interpretação dos sinalizadores que podem ser retornados no membro Estado :
FlavorBits = (Flags & DFS_VOLUME_FLAVORS)
If (FlavorBits == DFS_VOLUME_FLAVOR_STANDALONE) // namespace is stand-alone DFS
else if (FlavorBits == DFS_VOLUME_FLAVOR_AD_BLOB) // namespace is AD blob
else // unknown flavor
StateBits = (Flags & DFS_VOLUME_STATES)
// StateBits can be one of the following:
// (DFS_VOLUME_STATE_OK, DFS_VOLUME_STATE_INCONSISTENT,
// DFS_VOLUME_STATE_OFFLINE or DFS_VOLUME_STATE_ONLINE)
Requisitos
| Cliente mínimo com suporte | Windows Vista |
| Servidor mínimo com suporte | Windows Server 2008 |
| Cabeçalho | lmdfs.h (inclua LmDfs.h, Lm.h) |
Confira também
Funções do DFS (Sistema de Arquivos Distribuídos)