estrutura DFS_INFO_3 (lmdfs.h)

Artigo
08/24/2023

Contém informações sobre uma raiz ou link do DFS (Sistema de Arquivos Distribuído). Essa estrutura contém o nome, status, o número de destinos dfs e informações sobre cada destino da 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_3 {
  LPWSTR             EntryPath;
  LPWSTR             Comment;
  DWORD              State;
  DWORD              NumberOfStorages;
#if ...
  LPDFS_STORAGE_INFO Storage;
#else
  LPDFS_STORAGE_INFO Storage;
#endif
} DFS_INFO_3, *PDFS_INFO_3, *LPDFS_INFO_3;

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

\\ 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.