Funzione NetDfsSetClientInfo (lmdfs.h)

Modifica le informazioni su una radice DFS (Distributed File System) o un collegamento nella cache gestita dal client DFS.

Sintassi

NET_API_STATUS NET_API_FUNCTION NetDfsSetClientInfo(
  [in]           LPWSTR DfsEntryPath,
  [in, optional] LPWSTR ServerName,
  [in, optional] LPWSTR ShareName,
  [in]           DWORD  Level,
  [in]           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 del server di destinazione del collegamento DFS. Questo parametro è facoltativo e, Per altre informazioni, vedere la sezione Osservazioni.

[in, optional] ShareName

Puntatore a una stringa che specifica il nome della condivisione di destinazione del collegamento DFS. Questo parametro è facoltativo e, Per altre informazioni, vedere la sezione Osservazioni seguenti.

[in] Level

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

101

Impostare lo stato di archiviazione del collegamento DFS locale. Il parametro Buffer punta a una struttura DFS_INFO_101 .

102

Impostare il timeout del collegamento DFS locale. Il parametro Buffer punta a una struttura DFS_INFO_102 . Per ulteriori informazioni, vedere la sezione Osservazioni successiva.

[in] Buffer

Puntatore a un buffer che contiene le informazioni da impostare. Il formato di queste informazioni dipende dal valore del parametro Level . Per altre informazioni, vedere 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

Il chiamante deve avere privilegi di amministratore nel server DFS. Per altre informazioni sulla chiamata di funzioni che richiedono privilegi di amministratore, vedere Esecuzione con privilegi speciali.

L'impostazione del timeout su zero potrebbe non eliminare immediatamente la copia memorizzata nella cache locale del collegamento DFS, perché i thread possono fare riferimento alla voce.

Poiché è presente un solo timeout in un collegamento DFS, i parametri ServerName e ShareName vengono ignorati per il livello 102.

I bit di DFS_STORAGE_STATE_ONLINE e di DFS_STORAGE_STATE_OFFLINE verranno ignorati. Il bit di DFS_STORAGE_STATE_ACTIVE è valido solo se non sono aperti file al computer attivo.

Requisiti

Vedi anche

DFS_INFO_101

DFS_INFO_102

Funzioni DFS (Distributed File System)

NetDfsGetClientInfo

Funzioni di gestione della rete

Panoramica sulla gestione della rete