Condividi tramite

Condividere funzioni

Le funzioni di condivisione di gestione di rete controllano le risorse condivise. Una risorsa condivisa è una risorsa locale in un server (ad esempio, una directory del disco, un dispositivo di stampa o una named pipe) accessibile da utenti e applicazioni in rete.

Di seguito sono elencate le funzioni di condivisione.

Funzione Descrizione
NetShareAdd Condivide una risorsa in un server.
NetShareCheck Esegue una query se un server condivide un dispositivo.
NetShareDel Elimina un nome di condivisione dall'elenco di risorse condivise di un server.
NetShareEnum Recupera le informazioni sulla condivisione di ogni risorsa condivisa in un server.
NetShareGetInfo Recupera informazioni su una risorsa condivisa specificata in un server.
NetShareSetInfo Imposta i parametri di una risorsa condivisa.

 

Queste funzioni di condivisione si applicano solo alle condivisioni in un server Server Message Block (LAN Manager). Queste funzioni di condivisione non supportano condivisioni DFS (Distributed File System). Ad esempio, la funzione NetShareGetInfo può recuperare solo informazioni per una risorsa di condivisione specificata in un server SMB. Per recuperare informazioni per una condivisione usando un provider di rete diverso (WebDAV o una condivisione DFS, ad esempio), usare la funzioneWNetGetConnection.

La funzione NetShareAdd consente a un utente o a un'applicazione di condividere una risorsa di un tipo specifico usando il nome di condivisione specificato. La funzione NetShareAdd richiede il nome della condivisione e il nome del dispositivo locale per condividere la risorsa. Un utente o un'applicazione deve avere un account nel server per accedere alla risorsa.

È anche possibile specificare un descrittore di sicurezza da associare a una condivisione. I descrittori di sicurezza specificano quali utenti possono accedere ai file tramite la condivisione e con il tipo di accesso. Specificare un SECURITY_DESCRIPTOR con il livello di informazioni SHARE_INFO_502 quando si chiama NetShareAdd o NetShareSetInfo. NetShareSetInfo supporta il livello di informazioni SHARE_INFO_1501. Per altre informazioni sui descrittori di sicurezza, vedere Controllo di accesso.

Le funzioni di gestione della rete usano i seguenti nomi di condivisione speciali per la comunicazione interprocesso (IPC) e l'amministrazione remota del server:

  • IPC$, riservato per la comunicazione interprocesso
  • ADMIN$, riservato per l'amministrazione remota
  • A$, B$, C$ (e altri nomi dei dischi locali seguiti da un segno di dollaro), assegnati ai dispositivi disco locale

Per elencare tutte le connessioni effettuate a una risorsa condivisa in un server o elencare tutte le connessioni stabilite da un determinato computer, chiamare la funzione NetConnectionEnum. È possibile chiamare NetConnectionEnum a livello di informazioni CONNECTION_INFO_0 e CONNECTION_INFO_1.

Le funzioni di condivisione sono disponibili ai livelli di informazioni seguenti, anche se alcuni livelli di condivisione sono applicabili solo ad alcune delle funzioni di condivisione:

Per informazioni dettagliate, vedere la documentazione relativa a una funzione di condivisione specifica.

Se si esegue la programmazione per Active Directory, è possibile chiamare determinati metodi ADSI (Active Directory Service Interface) per ottenere la stessa funzionalità che è possibile ottenere chiamando le funzioni di condivisione di gestione di rete. Per altre informazioni, vedere IADsFileShare.