Función NetDfsGetSupportedNamespaceVersion (lmdfs.h)

Artículo
02/28/2024

Determina el número de versión de metadatos admitido.

Sintaxis

NET_API_STATUS NET_API_FUNCTION NetDfsGetSupportedNamespaceVersion(
  [in]  DFS_NAMESPACE_VERSION_ORIGIN          Origin,
  [in]  PWSTR                                 pName,
  [out] PDFS_SUPPORTED_NAMESPACE_VERSION_INFO *ppVersionInfo
);

Parámetros

[in] Origin

Valor de enumeración DFS_NAMESPACE_VERSION_ORIGIN que especifica el origen de la versión del espacio de nombres DFS.

[in] pName

Cadena que especifica el nombre del servidor o el nombre de dominio. Si el valor del parámetro Origin es DFS_NAMESPACE_VERSION_ORIGIN_DOMAIN, esta cadena debe ser un nombre de dominio de AD DS. De lo contrario, debe ser un nombre de servidor. Este parámetro es obligatorio y no puede ser NULL.

[out] ppVersionInfo

Puntero a una estructura de DFS_SUPPORTED_NAMESPACE_VERSION_INFO que recibe el número de versión de metadatos DFS.

Valor devuelto

Si la función se ejecuta correctamente, el valor devuelto es NERR_Success.

Si se produce un error en la función, el valor devuelto es un código de error del sistema. Para obtener una lista de códigos de error, consulte Códigos de error del sistema.

Comentarios

Esta función es útil para determinar un número de versión adecuado para pasar a la función NetDfsAddRootTarget .

El número de versión de los metadatos DFS que se pueden usar para un nuevo espacio de nombres DFS depende de lo siguiente:

En el caso de los espacios de nombres DFS basados en dominio, la versión admitida por el esquema de metadatos DFS que se usa en el dominio de AD DS.
La versión admitida por el servidor que va a hospedar el destino raíz DFS.

Por lo tanto, el número máximo de versión de metadatos DFS que se puede usar para un nuevo espacio de nombres DFS es el mínimo de la versión compatible con el dominio de AD DS y la versión compatible con el servidor. Este máximo se puede determinar llamando a la función NetDfsGetSupportedNamespaceVersion con el parámetro pName establecido en el nombre del servidor que va a hospedar el nuevo destino raíz DFS y el parámetro Origin establecido en DFS_NAMESPACE_VERSION_ORIGIN_COMBINED.

Requisitos

Requisito	Value
Cliente mínimo compatible	Windows Vista con SP1
Servidor mínimo compatible	Windows Server 2008
Plataforma de destino	Windows
Encabezado	lmdfs.h (include LmDfs.h, Lm.h)
Library	Netapi32.lib
Archivo DLL	Netapi32.dll