Função NetDfsGetSupportedNamespaceVersion (lmdfs.h)

Artigo
08/24/2023

Determina o número de versão de metadados com suporte.

Sintaxe

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

Um DFS_NAMESPACE_VERSION_ORIGIN valor de enumeração que especifica a origem da versão do namespace do DFS.

[in] pName

Uma cadeia de caracteres que especifica o nome do servidor ou o nome de domínio. Se o valor do parâmetro Origin for DFS_NAMESPACE_VERSION_ORIGIN_DOMAIN, essa cadeia de caracteres deverá ser um nome de domínio do AD DS. Caso contrário, ele deve ser um nome de servidor. Esse parâmetro é necessário e não pode ser NULL.

[out] ppVersionInfo

Um ponteiro para uma estrutura de DFS_SUPPORTED_NAMESPACE_VERSION_INFO que recebe o número de versão de metadados do DFS.

Retornar valor

Se a função for bem-sucedida, o valor retornado será NERR_Success.

Se a função falhar, o valor retornado será um código de erro do sistema. Para obter uma lista de códigos de erro, consulte Códigos de erro do sistema.

Comentários

Essa função é útil para determinar um número de versão apropriado para passar para a função NetDfsAddRootTarget .

O número de versão dos metadados do DFS que podem ser usados para um novo namespace do DFS depende do seguinte:

Para namespaces DFS baseados em domínio, a versão compatível com o esquema de metadados do DFS que está sendo usado no domínio do AD DS.
A versão com suporte do servidor que deve hospedar o destino raiz do DFS.

Assim, o número máximo de versão de metadados do DFS que pode ser usado para um novo namespace dfs é o mínimo da versão compatível com o domínio do AD DS e a versão com suporte do servidor. Esse máximo pode ser determinado chamando a função NetDfsGetSupportedNamespaceVersion com o parâmetro pName definido como o nome do servidor que deve hospedar o novo destino raiz do DFS e o parâmetro Origin definido como DFS_NAMESPACE_VERSION_ORIGIN_COMBINED.

Requisitos

Requisito	Valor
Cliente mínimo com suporte	Windows Vista com SP1
Servidor mínimo com suporte	Windows Server 2008
Plataforma de Destino	Windows
Cabeçalho	lmdfs.h (inclua LmDfs.h, Lm.h)
Biblioteca	Netapi32.lib
DLL	Netapi32.dll