NetDfsGetSupportedNamespaceVersion 関数 (lmdfs.h)

[アーティクル]
08/24/2023

サポートされているメタデータのバージョン番号を決定します。

構文

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

パラメーター

[in] Origin

DFS 名前空間のバージョンの配信元を指定する DFS_NAMESPACE_VERSION_ORIGIN列挙値。

[in] pName

サーバー名またはドメイン名を指定する文字列。 Origin パラメーターの値がDFS_NAMESPACE_VERSION_ORIGIN_DOMAIN場合、この文字列は AD DS ドメイン名である必要があります。それ以外の場合は、サーバー名にする必要があります。このパラメーターは必須であり、 NULL にすることはできません。

[out] ppVersionInfo

DFS メタデータのバージョン番号を受け取る DFS_SUPPORTED_NAMESPACE_VERSION_INFO 構造体へのポインター。

戻り値

関数が成功した場合、戻り値は NERR_Success。

関数が失敗した場合、戻り値はシステムエラーコードです。エラーコードの一覧については、「システムエラーコード」を参照してください。

注釈

この関数は、 NetDfsAddRootTarget 関数に渡す適切なバージョン番号を決定する際に役立ちます。

新しい DFS 名前空間に使用できる DFS メタデータのバージョン番号は、次によって異なります。

ドメインベースの DFS 名前空間の場合、AD DS ドメインで使用されている DFS メタデータスキーマでサポートされているバージョン。
DFS ルートターゲットをホストするサーバーでサポートされているバージョン。

したがって、新しい DFS 名前空間に使用できる DFS メタデータの最大バージョン番号は、AD DS ドメインでサポートされているバージョンとサーバーでサポートされているバージョンの最小値です。この最大値は、新しい DFS ルートターゲットをホストするサーバーの名前に pName パラメーターを設定し、Origin パラメーターを DFS_NAMESPACE_VERSION_ORIGIN_COMBINED に設定して、NetDfsGetSupportedNamespaceVersion 関数を呼び出すことによって決定できます。

要件

要件	値
サポートされている最小のクライアント	Windows Vista SP1
サポートされている最小のサーバー	Windows Server 2008
対象プラットフォーム	Windows
ヘッダー	lmdfs.h (LmDfs.h、Lm.h を含む)
Library	Netapi32.lib
[DLL]	Netapi32.dll