SHARE_INFO_502 struttura (lmshare.h)

Articolo
02/28/2024

Contiene informazioni sulla risorsa condivisa, incluso il nome della risorsa, il tipo e le autorizzazioni, il numero di connessioni e altre informazioni pertinenti.

Sintassi

typedef struct _SHARE_INFO_502 {
  LMSTR                shi502_netname;
  DWORD                shi502_type;
  LMSTR                shi502_remark;
  DWORD                shi502_permissions;
  DWORD                shi502_max_uses;
  DWORD                shi502_current_uses;
  LMSTR                shi502_path;
  LMSTR                shi502_passwd;
  DWORD                shi502_reserved;
  PSECURITY_DESCRIPTOR shi502_security_descriptor;
} SHARE_INFO_502, *PSHARE_INFO_502, *LPSHARE_INFO_502;

Members

shi502_netname

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

shi502_type

Combinazione di valori che specificano il tipo di condivisione. 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	Disco.
STYPE_PRINTQ	Stampa coda.
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 le funzioni di condivisione di rete.
STYPE_TEMPORARY	Condivisione temporanea.

shi502_remark

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

shi502_permissions

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

Si noti che Windows non supporta la sicurezza a livello di condivisione. Per altre informazioni sul controllo dell'accesso agli oggetti a protezione diretta, vedere Controllo di accesso, Privilegi e Oggetti a protezione diretta.

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 quando viene creata la 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 risorse e per modificare gli attributi e le autorizzazioni.

shi502_max_uses

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

shi502_current_uses

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

shi502_path

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

shi502_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. Si noti che Windows non supporta la sicurezza a livello di condivisione.

Questo membro non può essere più di SHPWLEN+1 byte (incluso un carattere null terminante). Le chiamate alla funzione NetShareSetInfo ignorano questo membro.

shi502_reserved

Riservati; deve essere zero. Le chiamate alla funzione NetShareSetInfo ignorano questo membro.

shi502_security_descriptor

Specifica la SECURITY_DESCRIPTOR associata a questa condivisione.

Requisiti

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