estructura DFS_INFO_5 (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 properties, metadata size y number of targets for the root or link. Esta estructura solo se usa con las funciones NetDfsEnum, NetDfsGetClientInfo y NetDfsGetInfo .
Para recuperar información sobre los destinos del espacio de nombres DFS, use DFS_INFO_6 en su lugar.
Sintaxis
typedef struct _DFS_INFO_5 {
LPWSTR EntryPath;
LPWSTR Comment;
DWORD State;
ULONG Timeout;
GUID Guid;
ULONG PropertyFlags;
ULONG MetadataSize;
DWORD NumberOfStorages;
} DFS_INFO_5, *PDFS_INFO_5, *LPDFS_INFO_5;
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. 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.
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 el 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)
Solo se devuelven destinos en el mismo sitio que el cliente. Esta marca es válida para los vínculos y raíces independientes del dominio.
DFS_PROPERTY_FLAG_ROOT_SCALABILITY (0x00000002)
Se sondea el controlador de dominio más cercano en lugar del PDC para los cambios en el espacio de nombres DFS. Esta marca solo es válida para raíces de dominio.
DFS_PROPERTY_FLAG_SITE_COSTING (0x00000004)
El costo del sitio de Active Directory de destinos está habilitado, agrupando destinos en conjuntos de costos de sitio crecientes del cliente DFS al destino. Cada conjunto tiene objetivos con el mismo costo. Esta marca solo es válida para raíces independientes y de dominio.
DFS_PROPERTY_FLAG_TARGET_FAILBACK (0x00000008)
El cliente DFS conmuta por recuperación a un destino disponible más cercano después de conmutar por error a un destino no óptimo. Esta marca es válida para los vínculos y raíces independientes del dominio.
DFS_PROPERTY_FLAG_CLUSTER_ENABLED (0x00000010)
La raíz DFS está agrupada. 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 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 miembro 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 miembro solo es válido para raíces DFS.
NumberOfStorages
Especifica el número de destinos para la raíz o el vínculo DFS.
Comentarios
Para recuperar información sobre los destinos y las prioridades de destino, use la estructura DFS_INFO_6 . DFS_INFO_5 se usa para especificar información sobre un espacio de nombres DFS sin información de destino.
Requisitos
| Cliente mínimo compatible | Windows Vista |
| Servidor mínimo compatible | Windows Server 2008, Windows Server 2008 |
| Encabezado | lmdfs.h (incluya LmDfs.h, Lm.h) |
Consulte también
Funciones del sistema de archivos distribuidos (DFS)