struttura SHARE_INFO_2 (lmshare.h)

Articolo
08/24/2023

Contiene informazioni sulla risorsa condivisa, inclusi il nome della risorsa, il tipo e le autorizzazioni e il numero di connessioni correnti. Per altre informazioni sul controllo dell'accesso a oggetti a protezione diretta, vedere Controllo di accesso, privilegi e oggetti a protezione diretta.

Sintassi

typedef struct _SHARE_INFO_2 {
  LMSTR shi2_netname;
  DWORD shi2_type;
  LMSTR shi2_remark;
  DWORD shi2_permissions;
  DWORD shi2_max_uses;
  DWORD shi2_current_uses;
  LMSTR shi2_path;
  LMSTR shi2_passwd;
} SHARE_INFO_2, *PSHARE_INFO_2, *LPSHARE_INFO_2;

Members

shi2_netname

Puntatore a una stringa Unicode che specifica il nome della condivisione di una risorsa. Le chiamate alla funzione NetShareSetInfo ignorano questo membro.

shi2_type

Combinazione di valori che specificano il tipo della risorsa condivisa. Le chiamate alla funzione NetShareSetInfo ignorano questo membro.

È possibile specificare uno dei valori seguenti. È possibile isolare questi valori usando il valore STYPE_MASK .

Valore	Significato
STYPE_DISKTREE	Unità disco rigido.
STYPE_PRINTQ	Coda di stampa.
STYPE_DEVICE	Dispositivo di comunicazione.
STYPE_IPC	Comunicazione interprocesso (IPC).

Inoltre, è possibile specificare uno o entrambi i valori seguenti.

Valore	Significato
STYPE_SPECIAL	Condivisione speciale riservata per la comunicazione interprocesso (IPC$) o l'amministrazione remota del server (ADMIN$). Può anche fare riferimento a condivisioni amministrative come C$, D$, E$e così via. Per altre informazioni, vedere Funzioni di condivisione di rete.
STYPE_TEMPORARY	Una condivisione temporanea.

shi2_remark

Puntatore a una stringa Unicode contenente un commento facoltativo sulla risorsa condivisa.

shi2_permissions

Specifica un valore DWORD che indica le autorizzazioni della risorsa condivisa per i server in esecuzione con sicurezza a livello di condivisione. Un server che esegue la sicurezza a livello di utente ignora questo membro. Questo membro può essere uno o più dei valori seguenti. Le chiamate alla funzione NetShareSetInfo ignorano questo membro.

Si noti che Windows non supporta la sicurezza a livello di condivisione.

Valore	Significato
ACCESS_READ	Autorizzazione per leggere i dati da una risorsa e, per impostazione predefinita, per eseguire la risorsa.
ACCESS_WRITE	Autorizzazione per scrivere dati nella risorsa.
ACCESS_CREATE	Autorizzazione per creare un'istanza della risorsa (ad esempio un file); i dati possono essere scritti nella risorsa durante la creazione della risorsa.
ACCESS_EXEC	Autorizzazione per eseguire la risorsa.
ACCESS_DELETE	Autorizzazione per eliminare la risorsa.
ACCESS_ATRIB	Autorizzazione per modificare gli attributi della risorsa, ad esempio la data e l'ora dell'ultima modifica di un file.
ACCESS_PERM	Autorizzazione per modificare le autorizzazioni (lettura, scrittura, creazione, esecuzione ed eliminazione) assegnate a una risorsa per un utente o un'applicazione.
ACCESS_ALL	Autorizzazione per leggere, scrivere, creare, eseguire ed eliminare le risorse e per modificare gli attributi e le autorizzazioni.

shi2_max_uses

Specifica un valore DWORD che indica il numero massimo di connessioni simultanee che la risorsa condivisa può contenere. Il numero di connessioni è illimitato se il valore specificato in questo membro è -1.

shi2_current_uses

Specifica un valore DWORD che indica il numero di connessioni correnti alla risorsa. Le chiamate alla funzione NetShareSetInfo ignorano questo membro.

shi2_path

Puntatore a una stringa Unicode che specifica il percorso locale per la risorsa condivisa. Per i dischi, shi2_path è il percorso condiviso. Per le code di stampa, shi2_path è il nome della coda di stampa condivisa. Le chiamate alla funzione NetShareSetInfo ignorano questo membro.

shi2_passwd

Puntatore a una stringa Unicode che specifica la password della condivisione quando il server è in esecuzione con sicurezza a livello di condivisione. Se il server è in esecuzione con sicurezza a livello di utente, questo membro viene ignorato. Il membro shi2_passwd non può essere più lungo di SHPWLEN+1 byte (incluso un carattere Null di terminazione). Le chiamate alla funzione NetShareSetInfo ignorano questo membro. Si noti che Windows non supporta la sicurezza a livello di condivisione.

Requisiti


Client minimo supportato	Windows XP [solo app desktop]
Server minimo supportato	Windows Server 2003 [solo app desktop]
Intestazione	lmshare.h (include Lm.h)