Funzione NetDfsGetClientInfo (lmdfs.h)

Recupera informazioni su una radice O un collegamento DFS (Distributed File System) dalla cache gestita dal client DFS.

Sintassi

NET_API_STATUS NET_API_FUNCTION NetDfsGetClientInfo(
  [in]           LPWSTR DfsEntryPath,
  [in, optional] LPWSTR ServerName,
  [in, optional] LPWSTR ShareName,
  [in]           DWORD  Level,
  [out]          LPBYTE *Buffer
);

Parametri

[in] DfsEntryPath

Puntatore a una stringa che specifica il percorso UNC (Universal Naming Convention) di una radice o un collegamento DFS.

Per un collegamento, la stringa può essere in una delle due forme. Il primo modulo è il seguente:

\\ Nomeserver\DfsName\link_path

dove ServerName è il nome del server di destinazione radice che ospita lo spazio dei nomi DFS autonomo; DfsName è il nome dello spazio dei nomi DFS; e link_path è un collegamento DFS.

Il secondo modulo è il seguente:

\\ Domainname\DomDfsname\link_path

dove DomainName è il nome del dominio che ospita lo spazio dei nomi DFS basato su dominio; DomDfsname è il nome dello spazio dei nomi DFS; e link_path è un collegamento DFS.

Per una radice, la stringa può essere in una delle due forme:

\\ Nomeserver\DfsName

oppure

\\ Domainname\DomDfsname

dove i valori dei nomi sono uguali a quelli descritti in precedenza.

Questo parametro è obbligatorio.

[in, optional] ServerName

Puntatore a una stringa che specifica il nome della destinazione radice DFS o del server di destinazione del collegamento. Questo parametro è facoltativo e,

[in, optional] ShareName

Puntatore a una stringa che specifica il nome della condivisione corrispondente alla destinazione radice O alla destinazione del collegamento DFS. Questo parametro è facoltativo e,

[in] Level

Specifica il livello di informazioni della richiesta. Questo parametro può avere uno dei valori seguenti.

1

Restituisce il nome di collegamento DFS radice o DFS. Il parametro Buffer punta a una struttura DFS_INFO_1 .

2

Restituisce il nome del collegamento DFS radice o DFS, lo stato e il numero di destinazioni DFS. Il parametro Buffer punta a una struttura DFS_INFO_2 .

3

Restituisce il nome del collegamento DFS radice o DFS, lo stato e le informazioni di destinazione. Il parametro Buffer punta a una struttura DFS_INFO_3 .

4

Restituisce il nome del collegamento DFS radice o DFS, stato, GUID, timeout e informazioni di destinazione. Il parametro Buffer punta a una struttura DFS_INFO_4 .

[out] Buffer

Puntatore all'indirizzo di un buffer che riceve le informazioni richieste. Questo buffer viene allocato dal sistema e deve essere liberato usando la funzione NetApiBufferFree . Per altre informazioni, vedere Buffer delle funzioni di gestione della rete e lunghezze del buffer delle funzioni di gestione della rete.

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

Non è necessaria alcuna appartenenza a gruppi speciali per l'uso della funzione NetDfsGetClientInfo .

Requisiti

Vedi anche

DFS_INFO_1

DFS_INFO_2

DFS_INFO_3

DFS_INFO_4

Funzioni DFS (Distributed File System)

NetDfsSetClientInfo

Funzioni di gestione della rete

Panoramica sulla gestione della rete