NetDfsGetSupportedNamespaceVersion function

Determines the supported metadata version number.

Syntax


NET_API_STATUS NET_API_FUNCTION NetDfsGetSupportedNamespaceVersion(
  _In_  DFS_NAMESPACE_VERSION_ORIGIN          Origin,
  _In_  PWSTR                                 pName,
  _Out_ PDFS_SUPPORTED_NAMESPACE_VERSION_INFO *ppVersionInfo
);

Parameters

Origin [in]

A DFS_NAMESPACE_VERSION_ORIGIN enumeration value that specifies the origin of the DFS namespace version.

pName [in]

A string that specifies the server name or domain name. If the value of the Origin parameter is DFS_NAMESPACE_VERSION_ORIGIN_DOMAIN, this string must be an AD DS domain name. Otherwise, it must be a server name. This parameter is required and cannot be NULL.

ppVersionInfo [out]

A pointer to a DFS_SUPPORTED_NAMESPACE_VERSION_INFO structure that receives the DFS metadata version number.

Return value

If the function succeeds, the return value is NERR_Success.

If the function fails, the return value is a system error code. For a list of error codes, see System Error Codes.

Remarks

This function is useful in determining an appropriate version number to pass to the NetDfsAddRootTarget function.

The version number of the DFS metadata that can be used for a new DFS namespace depends on the following:

  • For domain-based DFS namespaces, the version supported by the DFS metadata schema that is being used in the AD DS domain.
  • The version supported by the server that is to host the DFS root target.

Thus, the maximum DFS metadata version number that can be used for a new DFS namespace is the minimum of the version supported by the AD DS domain and the version supported by the server. This maximum can be determined by calling the NetDfsGetSupportedNamespaceVersion function with the pName parameter set to the name of the server that is to host the new DFS root target and the Origin parameter set to DFS_NAMESPACE_VERSION_ORIGIN_COMBINED.

Requirements

Minimum supported client

Windows Vista with SP1

Minimum supported server

Windows Server 2008

Header

LmDfs.h (include LmDfs.h or Lm.h)

Library

Netapi32.lib

DLL

Netapi32.dll

See also

Network Management Overview
Network Management Functions
Distributed File System (DFS) Functions
DFS_NAMESPACE_VERSION_ORIGIN
DFS_SUPPORTED_NAMESPACE_VERSION_INFO
NetDfsAddRootTarget

 

 

Show: