estructura DFS_INFO_6 (lmdfs.h)
Contiene información sobre una raíz o vínculo del sistema de archivos distribuido (DFS). Esta estructura contiene las propiedades name, status, GUID, time-out, namespace/root/link, el tamaño de los metadatos, el número de destinos y la información sobre cada destino de la raíz o vínculo. Esta estructura solo se usa con las funciones NetDfsEnum, NetDfsGetClientInfo y NetDfsGetInfo .
Para obtener información sobre el espacio de nombres DFS sin información de destino, use DFS_INFO_5 en su lugar.
Sintaxis
typedef struct _DFS_INFO_6 {
LPWSTR EntryPath;
LPWSTR Comment;
DWORD State;
ULONG Timeout;
GUID Guid;
ULONG PropertyFlags;
ULONG MetadataSize;
DWORD NumberOfStorages;
#if ...
LPDFS_STORAGE_INFO_1 Storage;
#else
LPDFS_STORAGE_INFO_1 Storage;
#endif
} DFS_INFO_6, *PDFS_INFO_6, *LPDFS_INFO_6;
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 tener 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 marca DFS_VOLUME_FLAVOR . La máscara de bits 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 raíz o de vínculo 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 ha producido un error 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.
Timeout
Especifica el tiempo de espera, en segundos, de la raíz o el vínculo DFS.
Guid
Especifica el GUID de la raíz o vínculo DFS.
PropertyFlags
Especifica un conjunto de marcas que describen propiedades específicas de un espacio de nombres DFS, raíz o vínculo.
DFS_PROPERTY_FLAG_INSITE_REFERRALS (0x00000001)
Ámbito: raíces de dominio, raíces independientes y vínculos. Si esta marca se establece en la raíz DFS, se aplica a todos los vínculos; de lo contrario, el valor de esta marca se considera para cada vínculo individual.
Cuando se establece esta marca, una respuesta de referencia DFS de un servidor DFS para una raíz o vínculo DFS con la opción "INSITE" habilitada contiene solo los destinos que están en el mismo sitio que el cliente DFS que solicita la referencia. Los destinos de las dos clases de prioridad global siempre se devuelven, independientemente de su ubicación del sitio.
DFS_PROPERTY_FLAG_ROOT_SCALABILITY (0x00000002)
Ámbito: el espacio de nombres DFS completo solo para un espacio de nombres DFS basado en dominio.
De forma predeterminada, un servidor de destino raíz DFS sondea el PDS para detectar cambios en los metadatos de DFS. Para evitar una carga pesada del servidor en el PDC, se puede habilitar la escalabilidad raíz para el espacio de nombres DFS. Establecer esta marca hará que el servidor DFS sondee el controlador de dominio más cercano en lugar del PDC para los cambios de metadatos DFS para el espacio de nombres común. Tenga en cuenta que los cambios realizados en los metadatos deben seguir apareciendo en el PDC, sin embargo.
DFS_PROPERTY_FLAG_SITE_COSTING (0x00000004)
Ámbito: todo el espacio de nombres DFS para los espacios de nombres DFS basados en dominio y independientes.
De forma predeterminada, los destinos devueltos en una respuesta de referencia de un servidor DFS a un cliente DFS para una raíz o vínculo DFS constan de dos grupos: destinos en el mismo sitio que el cliente y destinos fuera del sitio.
Si el costo del sitio está habilitado para Active Directory, la respuesta puede tener más de dos grupos, con cada grupo que contenga destinos con el mismo costo de sitio para el cliente DFS específico que solicita la referencia. Los grupos se ordenan aumentando el costo del sitio. Para obtener más información sobre cómo se usa el costo del sitio para priorizar los destinos, consulte Priorización de destino del servidor DFS.
DFS_PROPERTY_FLAG_TARGET_FAILBACK (0x00000008)
Ámbito: raíces DFS basadas en dominio, raíces DFS independientes y vínculos DFS. Si esta marca se establece en la raíz DFS, se aplica a todos los vínculos; de lo contrario, el valor de esta marca se considera para cada vínculo individual.
Cuando se establece esta marca, la conmutación por recuperación de destino óptima está habilitada para los clientes DFS V4, lo que les permite conmutar por recuperación a un destino óptimo después de conmutar por error a uno no óptimo. La configuración de conmutación por recuperación de destino se proporciona al cliente DFS en una respuesta de referencia V4 por un servidor DFS.
DFS_PROPERTY_FLAG_CLUSTER_ENABLED (0x00000010)
Ámbito: raíces y vínculos DFS independientes solo.
La raíz DFS está agrupada para proporcionar alta disponibilidad para la conmutación por error de almacenamiento. Esta marca no se puede establecer mediante la función NetDfsSetInfo .
DFS_PROPERTY_FLAG_ABDE (0x00000020)
Ámbito: raíces DFS basadas en dominio y raíces DFS independientes.
Cuando se establece esta marca, Access-Based compatibilidad con el modo enumeración de directorios (ABDE) está habilitada en todo el recurso compartido de destino raíz DFS del espacio de nombres DFS. Esta marca solo es válida para los espacios de nombres DFS para los que se establece la marca de funcionalidad DFS_NAMESPACE_CAPABILITY_ABDE . Para obtener más información, consulte DFS_INFO_50 y DFS_SUPPORTED_NAMESPACE_VERSION_INFO.
La marca DFS_PROPERTY_FLAG_ABDE solo es válida en la raíz del espacio de nombres DFS y no en destinos raíz, vínculos o destinos de vínculo. Esta marca debe estar habilitada para asociar un descriptor de seguridad a un vínculo DFS.
MetadataSize
En el caso de los espacios de nombres DFS basados en dominio, este miembro especifica el tamaño del blob de datos de Active Directory correspondiente, en bytes. En el caso de los espacios de nombres DFS independientes, este campo especifica el tamaño de los metadatos almacenados en el Registro, incluidos los nombres de clave y los nombres de valor, así como los elementos de datos específicos asociados a ellos.
Este campo solo es válido para raíces DFS.
NumberOfStorages
Especifica el número de destinos para la raíz o el vínculo DFS. Estos destinos se encuentran en el miembro Storage de esta estructura.
Storage
Especifica una matriz de estructuras de DFS_STORAGE_INFO_1 que contienen la información de destino DFS.
Comentarios
Para obtener más información sobre cómo se determina la prioridad de destino del servidor, consulte Priorización de destino del servidor DFS.
Requisitos
| Requisito | Value |
|---|---|
| Cliente mínimo compatible | Windows Vista |
| Servidor mínimo compatible | Windows Server 2008, Windows Server 2008 |
| Encabezado | lmdfs.h (include LmDfs.h, Lm.h) |
Consulte también
Priorización de destino del servidor DFS
Funciones del sistema de archivos distribuido (DFS)