SHARE_INFO_503 struttura (lmshare.h)

Articolo
03/14/2023

Contiene informazioni sulla risorsa condivisa. È identico alla struttura SHARE_INFO_502 , ad eccezione del fatto che contiene anche il nome del server.

Sintassi

typedef struct _SHARE_INFO_503 {
  LMSTR                shi503_netname;
  DWORD                shi503_type;
  LMSTR                shi503_remark;
  DWORD                shi503_permissions;
  DWORD                shi503_max_uses;
  DWORD                shi503_current_uses;
  LMSTR                shi503_path;
  LMSTR                shi503_passwd;
  LMSTR                shi503_servername;
  DWORD                shi503_reserved;
  PSECURITY_DESCRIPTOR shi503_security_descriptor;
} SHARE_INFO_503, *PSHARE_INFO_503, *LPSHARE_INFO_503;

Members

shi503_netname

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

shi503_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 0x00000000	Unità disco rigido.
STYPE_PRINTQ 0x00000001	Stampa coda.
STYPE_DEVICE 0x00000002	Dispositivo di comunicazione.
STYPE_IPC 0x00000003	Comunicazione interprocesso (IPC).

È inoltre possibile specificare uno o entrambi i valori seguenti.

Valore	Significato
STYPE_SPECIAL 0x80000000	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 0x40000000	Condivisione temporanea.

shi503_remark

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

shi503_permissions

Specifica un valore DWORD che indica le autorizzazioni della risorsa condivisa per i server in esecuzione con sicurezza a livello di condivisione. Si noti che Windows non supporta la sicurezza a livello di condivisione. Questo membro viene ignorato in un server che esegue la sicurezza a livello di utente. Per altre informazioni sul controllo dell'accesso agli oggetti a protezione diretta, vedere Controllo di accesso, Privilegi e Oggetti a protezione diretta.

Le chiamate alla funzione NetShareSetInfo ignorano questo membro.

Questo membro può essere uno dei valori seguenti.

Valore	Significato
ACCESS_READ 0x00000001	Autorizzazione per leggere i dati da una risorsa e, per impostazione predefinita, per eseguire la risorsa.
ACCESS_WRITE 0x00000002	Autorizzazione per scrivere dati nella risorsa.
ACCESS_CREATE 0x00000004	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 0x00000008	Autorizzazione per eseguire la risorsa.
ACCESS_DELETE 0x00000010	Autorizzazione per eliminare la risorsa.
ACCESS_ATRIB 0x00000020	Autorizzazione per modificare gli attributi della risorsa, ad esempio la data e l'ora dell'ultima modifica di un file.
ACCESS_PERM 0x00000040	Autorizzazione per modificare le autorizzazioni (lettura, scrittura, creazione, esecuzione ed eliminazione) assegnate a una risorsa per un utente o un'applicazione.
ACCESS_ALL 0x00008000	Autorizzazione per leggere, scrivere, creare, eseguire ed eliminare risorse e per modificare gli attributi e le autorizzazioni.

shi503_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.

shi503_current_uses

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

shi503_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.

shi503_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.

shi503_servername

Puntatore a una stringa che specifica il nome DNS o NetBIOS del server remoto in cui risiede la risorsa condivisa. Il valore "*" indica che non è stato configurato alcun nome del server configurato.

shi503_reserved

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

shi503_security_descriptor

Specifica la SECURITY_DESCRIPTOR associata a questa condivisione.

Commenti

Il server remoto specificato nel membro shi503_servername deve essere associato a un protocollo di trasporto usando la funzione NetServerTransportAddEx . Nella chiamata a NetServerTransportAddEx è necessario specificare 2 o 3 per il parametro di livello e il valore SVTI2_SCOPED_NAME deve essere stato specificato nella struttura SERVER_TRANSPORT_INFO_2 per il protocollo di trasporto.

Requisiti


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