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:

SHARE_INFO_0
SHARE_INFO_1
SHARE_INFO_2
SHARE_INFO_501
SHARE_INFO_502
SHARE_INFO_1005

I livelli di informazioni seguenti sono validi solo per NetShareSetInfo:

SHARE_INFO_1004
SHARE_INFO_1006
SHARE_INFO_1501

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.