Condividi tramite

Funzioni di condivisione

  • Articolo

Le funzioni di condivisione di gestione della 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 pipe denominata, a cui è possibile accedere dagli utenti e dalle applicazioni nella rete.

Le funzioni di condivisione sono elencate di seguito.

Funzione Descrizione
NetShareAdd Condivide una risorsa in un server.
NetShareCheck Esegue una query sul fatto che un server stia condividendo un dispositivo.
NetShareDel Elimina un nome di condivisione dall'elenco di risorse condivise di un server.
NetShareEnum Recupera informazioni di condivisione su 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 funzione WNetGetConnection .

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 tra processi
  • ADMIN$, riservato per l'amministrazione remota
  • A$, B$, C$ (e altri nomi di dischi locali seguiti da un segno dollaro), assegnati ai dispositivi disco locali

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 ai livelli di informazioni di CONNECTION_INFO_0 e CONNECTION_INFO_1 .

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

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

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