DFS_INFO_2 struttura (lmdfs.h)

Articolo
08/24/2023

Contiene informazioni su una radice o un collegamento DFS (Distributed File System). Questa struttura contiene il nome, lo stato e il numero di destinazioni DFS per la radice o il collegamento. Questa struttura è utilizzata solo con le funzioni NetDfsEnum, NetDfsGetClientInfo e NetDfsGetInfo e il codice di controllo FSCTL_DFS_GET_PKT_ENTRY_STATE .

Sintassi

typedef struct _DFS_INFO_2 {
  LPWSTR EntryPath;
  LPWSTR Comment;
  DWORD  State;
  DWORD  NumberOfStorages;
} DFS_INFO_2, *PDFS_INFO_2, *LPDFS_INFO_2;

Members

EntryPath

Puntatore a una stringa Unicode con terminazione null che specifica il percorso UNIVERSAL Naming Convention (UNC) di una radice o un collegamento DFS.

Per un collegamento, la stringa può essere in una delle due forme. Il primo modulo è il seguente:

\\Nomeserver\DfsName\link_path

dove ServerName è il nome del server di destinazione radice che ospita lo spazio dei nomi DFS autonomo; DfsName è il nome dello spazio dei nomi DFS; e link_path è un collegamento DFS.

Il secondo modulo è il seguente:

\\Domainname\DomDfsname\link_path

dove DomainName è il nome del dominio che ospita lo spazio dei nomi DFS basato su dominio; DomDfsname è il nome dello spazio dei nomi DFS; e link_path è un collegamento DFS.

Per una radice, la stringa può essere in una delle due forme:

\\Nomeserver\DfsName

oppure

\\Domainname\DomDfsname

dove i valori dei nomi sono uguali a quelli descritti in precedenza.

Comment

Puntatore a una stringa Unicode con terminazione null contenente un commento associato alla radice o al collegamento DFS.

State

Specifica un set di flag di bit che descrivono la radice o il collegamento DFS. Viene impostato un flag DFS_VOLUME_STATE e viene impostato un flag DFS_VOLUME_FLAVOR . Il DFS_VOLUME_FLAVORS maschera di bit ( 0x00000300) deve essere usato per estrarre il sapore dello spazio dei nomi DFS e la maschera di bit DFS_VOLUME_STATES (0x0000000F) deve essere usata per estrarre lo stato radice o collegamento DFS da questo membro. Per un esempio che descrive l'interpretazione dei flag, vedere la sezione Osservazioni seguente.

DFS_VOLUME_STATE_OK (0x00000001)

La radice o il collegamento DFS specificato si trova nello stato normale.

DFS_VOLUME_STATE_INCONSISTENT (0x00000002)

Il database DFS interno non è coerente con la radice o il collegamento DFS specificato. I tentativi di ripristino della incoerenza non sono riusciti.

DFS_VOLUME_STATE_OFFLINE (0x00000003)

Il collegamento radice o radice DFS specificato è offline o non disponibile.

DFS_VOLUME_STATE_ONLINE (0x00000004)

La radice o il collegamento DFS specificato sono disponibili.

DFS_VOLUME_FLAVOR_STANDALONE (0x00000100)

Il sistema imposta questo flag se la radice è associata a uno spazio dei nomi DFS autonomo.

DFS_VOLUME_FLAVOR_AD_BLOB (0x00000200)

Il sistema imposta questo flag se la radice è associata a uno spazio dei nomi DFS basato su dominio.

NumberOfStorages

Specifica il numero di destinazioni DFS.

Commenti

Le funzioni DFS usano la struttura DFS_INFO_2 per recuperare informazioni su una radice o un collegamento DFS.

Di seguito è riportato un esempio che descrive l'interpretazione dei flag che possono essere restituiti nel membro dello Stato :

FlavorBits = (Flags &amp; 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 &amp; 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)