estructura DFS_INFO_3 (lmdfs.h)

Artículo
03/05/2024

Contiene información sobre una raíz o vínculo del sistema de archivos distribuido (DFS). Esta estructura contiene el nombre, el estado, el número de destinos DFS e información sobre cada destino de la raíz o el vínculo. Esta estructura solo se usa con las funciones NetDfsEnum, NetDfsGetClientInfo y NetDfsGetInfo y el código de control de FSCTL_DFS_GET_PKT_ENTRY_STATE .

Sintaxis

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;

Miembros

EntryPath

Puntero a una cadena Unicode terminada en null que especifica la ruta de acceso de convención de nomenclatura universal (UNC) de una raíz o vínculo DFS.

Para un vínculo, la cadena puede estar en una de las dos formas. El primer formulario es el siguiente:

\\Nombredeservidor\DfsName\link_path

donde ServerName es el nombre del servidor de destino raíz que hospeda el espacio de nombres DFS independiente; DfsName es el nombre del espacio de nombres DFS; y link_path es un vínculo DFS.

El segundo formulario es el siguiente:

\\Nombrededominio\DomDfsname\link_path

donde DomainName es el nombre del dominio que hospeda el espacio de nombres DFS basado en dominio; DomDfsname es el nombre del espacio de nombres DFS; y link_path es un vínculo DFS.

Para una raíz, la cadena puede estar en una de estas dos formas:

\\Nombredeservidor\DfsName

\\Nombrededominio\DomDfsname

donde los valores de los nombres son los mismos que los descritos anteriormente.

Comment

Puntero a una cadena Unicode terminada en null que contiene un comentario asociado a la raíz o vínculo DFS.

State

Especifica un conjunto de marcas de bits que describen la raíz o el vínculo DFS. Se establece una marca de DFS_VOLUME_STATE y se establece una DFS_VOLUME_FLAVOR marca. La máscara de bits de DFS_VOLUME_FLAVORS (0x00000300) debe usarse para extraer el tipo de espacio de nombres DFS y la máscara de bits (0x0000000F) DFS_VOLUME_STATES debe usarse para extraer el estado de vínculo o raíz DFS de este miembro. Para obtener un ejemplo que describa la interpretación de las marcas, vea la sección Comentarios de DFS_INFO_2.

DFS_VOLUME_STATE_OK (0x00000001)

La raíz o vínculo DFS especificado está en estado normal.

DFS_VOLUME_STATE_INCONSISTENT (0x00000002)

La base de datos DFS interna es incoherente con la raíz o vínculo DFS especificado. Se han producido errores en los intentos de reparación de la incoherencia.