estructura DFS_INFO_8 (lmdfs.h)
Contiene el nombre, el estado, el GUID, el tiempo de espera, las marcas de propiedad, el tamaño de los metadatos, la información de destino DFS y el descriptor de seguridad de punto de reanálisis de vínculos para una raíz o vínculo. Esta estructura solo se usa con las funciones NetDfsGetInfo y NetDfsEnum .
Sintaxis
typedef struct _DFS_INFO_8 {
LPWSTR EntryPath;
LPWSTR Comment;
DWORD State;
ULONG Timeout;
GUID Guid;
ULONG PropertyFlags;
ULONG MetadataSize;
ULONG SecurityDescriptorLength;
#if ...
PUCHAR pSecurityDescriptor;
ULONG SdLengthReserved;
#else
PSECURITY_DESCRIPTOR pSecurityDescriptor;
#endif
DWORD NumberOfStorages;
} DFS_INFO_8, *PDFS_INFO_8, *LPDFS_INFO_8;
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 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)
Á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 DFS o un vínculo 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 DFS. Para evitar la carga pesada del servidor en el PDC, la escalabilidad raíz se puede habilitar 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: espacio de nombres DFS completo para espacios de nombres DFS independientes y basados en dominio.
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 de 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 de 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 parte de un servidor DFS.
DFS_PROPERTY_FLAG_CLUSTER_ENABLED (0x00000010)
Ámbito: solo raíces y vínculos DFS independientes.
La raíz DFS se agrupa 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 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, además de los elementos de datos específicos asociados a ellos.
Este campo solo es válido para raíces DFS.
SecurityDescriptorLength
pSecurityDescriptor
Puntero a una estructura de SECURITY_DESCRIPTOR que especifica un descriptor de seguridad auto relativo que se va a asociar al punto de reanálisis del vínculo DFS. Este campo solo es válido para los vínculos DFS.
SdLengthReserved
Este miembro está reservado para uso del sistema.
NumberOfStorages
Especifica el número de servidores de almacenamiento para el volumen que contiene la raíz o el vínculo DFS.
Requisitos
| Cliente mínimo compatible | Windows Vista con SP1 |
| Servidor mínimo compatible | Windows Server 2008 |
| Encabezado | lmdfs.h (incluya LmDfs.h, Lm.h) |