estructura DFS_INFO_2 (lmdfs.h)
Contiene información sobre una raíz o vínculo del sistema de archivos distribuido (DFS). Esta estructura contiene el nombre, el estado y el número de destinos DFS para 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_2 {
LPWSTR EntryPath;
LPWSTR Comment;
DWORD State;
DWORD NumberOfStorages;
} DFS_INFO_2, *PDFS_INFO_2, *LPDFS_INFO_2;
Members
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
o
\\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 siguiente.
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.
DFS_VOLUME_STATE_OFFLINE (0x00000003)
La raíz o vínculo DFS especificado está sin conexión o no está disponible.
DFS_VOLUME_STATE_ONLINE (0x00000004)
La raíz o vínculo DFS especificado está disponible.
DFS_VOLUME_FLAVOR_STANDALONE (0x00000100)
El sistema establece esta marca si la raíz está asociada a un espacio de nombres DFS independiente.
DFS_VOLUME_FLAVOR_AD_BLOB (0x00000200)
El sistema establece esta marca si la raíz está asociada a un espacio de nombres DFS basado en dominio.
NumberOfStorages
Especifica el número de destinos DFS.
Comentarios
Las funciones DFS usan la estructura DFS_INFO_2 para recuperar información sobre una raíz o vínculo DFS.
A continuación se muestra un ejemplo que describe la interpretación de las marcas que se pueden devolver en el miembro del 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 compatible | Windows Vista |
| Servidor mínimo compatible | Windows Server 2008 |
| Encabezado | lmdfs.h (incluya LmDfs.h, Lm.h) |
Consulte también
Funciones del sistema de archivos distribuidos (DFS)