estructura DFS_INFO_107 (lmdfs.h)
Contiene información sobre una raíz o vínculo DFS, incluidos el comentario, el estado, el tiempo de espera, las marcas de propiedad y el descriptor de seguridad de punto de análisis de vínculos. Esta estructura solo se usa con las funciones NetDfsGetInfo y NetDfsSetInfo .
Sintaxis
typedef struct _DFS_INFO_107 {
LPWSTR Comment;
DWORD State;
ULONG Timeout;
ULONG PropertyFlagMask;
ULONG PropertyFlags;
ULONG SecurityDescriptorLength;
#if ...
PUCHAR pSecurityDescriptor;
ULONG SdLengthReserved;
#else
PSECURITY_DESCRIPTOR pSecurityDescriptor;
#endif
} DFS_INFO_107, *PDFS_INFO_107, *LPDFS_INFO_107;
Miembros
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.
PropertyFlagMask
Especifica un valor de máscara que indica qué marcas son válidas para la evaluación en el campo PropertyFlags .
PropertyFlags
Campo de bits, con cada bit responsable de una propiedad específica aplicable al espacio de nombres DFS completo, la raíz DFS o un vínculo DFS individual, dependiendo de la propiedad real. Se permite cualquier combinación de bits a menos que se indique lo contrario.
DFS_PROPERTY_FLAG_INSITE_REFERRALS (0x00000001)
Respuesta de referencia de un servidor DFS para una raíz o vínculo DFS que contiene solo los destinos en el mismo sitio que el cliente que solicita la referencia. Los destinos de las dos clases de prioridad global siempre se devuelven, independientemente de su ubicación del sitio. Esta marca se aplica a 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, se aplica a un vínculo individual. La configuración del vínculo no invalida la configuración raíz.
DFS_PROPERTY_FLAG_ROOT_SCALABILITY (0x00000002)
Si se establece esta marca, el servidor DFS sondea el controlador de dominio (DC) más cercano en lugar del controlador de dominio principal (PDC) para comprobar si el espacio de nombres DFS cambia para ese espacio de nombres. Cualquier modificación de los metadatos DFS por parte del servidor DFS no está controlada por esta marca, sino que se envía al PDC. Esta marca es válida para todo el espacio de nombres y solo se aplica a los espacios de nombres DFS basados en dominio.
DFS_PROPERTY_FLAG_SITE_COSTING (0x00000004)
Establezca esta marca para habilitar el costo del sitio de Active Directory de destinos. Los destinos devueltos desde el servidor DFS al cliente DFS solicitante se agrupan por costo entre sitios con respecto al cliente DFS. Los grupos se ordenan en términos de aumento del costo del sitio con el primer grupo que consta de destinos en el mismo sitio que el cliente. Los destinos de cada grupo se ordenan aleatoriamente.
Si esta marca no está habilitada, la devolución predeterminada es dos conjuntos: un conjunto de destinos en el mismo sitio que el cliente y un conjunto de todos los destinos restantes. Esta marca es válida para todo el espacio de nombres DFS y se aplica a los espacios de nombres DFS basados en dominio y independientes.
Las prioridades de destino pueden influir aún más en la ordenación de los objetivos. 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)
Establezca esta marca para permitir que los clientes DFS V4 conmuten por recuperación a un destino más óptimo (menor costo o prioridad mayor). Si esta marca se establece en la raíz DFS, se aplica a todos los vínculos; de lo contrario, se aplica a un vínculo individual. Una configuración de vínculo individual no invalidará una configuración raíz. La configuración de conmutación por recuperación de destino se proporciona al cliente DFS en una respuesta de referencia V4 por parte del servidor DFS. Esta marca se aplica a raíces basadas en dominio, raíces independientes y vínculos.
DFS_PROPERTY_FLAG_CLUSTER_ENABLED (0x00000010)
Si se establece esta marca, 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 y solo se aplica a los vínculos y raíces DFS independientes.
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.
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.
Requisitos
| Requisito | Value |
|---|---|
| Cliente mínimo compatible | Windows Vista con SP1 |
| Servidor mínimo compatible | Windows Server 2008 |
| Encabezado | lmdfs.h (include LmDfs.h, Lm.h) |