Funzione NetDfsGetSupportedNamespaceVersion (lmdfs.h)

Determina il numero di versione dei metadati supportato.

Sintassi

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

Parametri

[in] Origin

Valore di enumerazione DFS_NAMESPACE_VERSION_ORIGIN che specifica l'origine della versione dello spazio dei nomi DFS.

[in] pName

Stringa che specifica il nome del server o il nome di dominio. Se il valore del parametro Origin è DFS_NAMESPACE_VERSION_ORIGIN_DOMAIN, questa stringa deve essere un nome di dominio di Active Directory Domain Services. In caso contrario, deve essere un nome del server. Questo parametro è obbligatorio e non può essere NULL.

[out] ppVersionInfo

Puntatore a una struttura DFS_SUPPORTED_NAMESPACE_VERSION_INFO che riceve il numero di versione dei metadati DFS.

Valore restituito

Se la funzione ha esito positivo, il valore restituito è NERR_Success.

Se la funzione ha esito negativo, il valore restituito è un codice di errore di sistema. Per un elenco di codici di errore, vedere Codici di errore di sistema.

Commenti

Questa funzione è utile per determinare un numero di versione appropriato da passare alla funzione NetDfsAddRootTarget .

Il numero di versione dei metadati DFS che possono essere usati per un nuovo spazio dei nomi DFS dipende dal seguente:

  • Per gli spazi dei nomi DFS basati su dominio, la versione supportata dallo schema dei metadati DFS usato nel dominio Active Directory Domain Services.
  • Versione supportata dal server che ospita la destinazione radice DFS.
Pertanto, il numero massimo di versione dei metadati DFS che può essere usato per un nuovo spazio dei nomi DFS è il minimo della versione supportata dal dominio Active Directory Domain Services e dalla versione supportata dal server. Questo massimo può essere determinato chiamando la funzione NetDfsGetSupportedNamespaceVersion con il parametro pName impostato sul nome del server che ospita la nuova destinazione radice DFS e il parametro Origin impostato su DFS_NAMESPACE_VERSION_ORIGIN_COMBINED.

Requisiti

Requisito Valore
Client minimo supportato Windows Vista con SP1
Server minimo supportato Windows Server 2008
Piattaforma di destinazione Windows
Intestazione lmdfs.h (include LmDfs.h, Lm.h)
Libreria Netapi32.lib
DLL Netapi32.dll

Vedi anche

DFS_NAMESPACE_VERSION_ORIGIN

DFS_SUPPORTED_NAMESPACE_VERSION_INFO

Funzioni DFS (Distributed File System)

NetDfsAddRootTarget

Funzioni di gestione della rete

Panoramica sulla gestione della rete