Funzioni di condivisione di rete
Le funzioni di condivisione 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 nella rete.
Di seguito sono elencate le funzioni di condivisione.
Funzione | Descrizione |
---|---|
NetShareAdd | Condivide una risorsa in un server. |
NetShareCheck | Esegue una query per stabilire 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. |
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 di rete usano i nomi di condivisione speciali seguenti 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 locali
Per elencare tutte le connessioni effettuate a una risorsa condivisa in un server o per 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:
I livelli di informazioni seguenti sono validi solo per NetShareSetInfo:
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.