SHARE_INFO_2-Struktur (lmshare.h)

Artikel
08/24/2023

Enthält Informationen zur freigegebenen Ressource, einschließlich Name der Ressource, Typ und Berechtigungen sowie die Anzahl der aktuellen Verbindungen. Weitere Informationen zum Steuern des Zugriffs auf sicherungsfähige Objekte finden Sie unter Access Control, Berechtigungen und sicherungsfähige Objekte.

Syntax

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

Zeiger auf eine Unicode-Zeichenfolge, die den Freigabenamen einer Ressource angibt. Aufrufe der NetShareSetInfo-Funktion ignorieren diesen Member.

shi2_type

Eine Kombination von Werten, die den Typ der freigegebenen Ressource angeben. Aufrufe der NetShareSetInfo-Funktion ignorieren diesen Member.

Einer der folgenden Werte kann angegeben werden. Sie können diese Werte mithilfe des werts STYPE_MASK isolieren.

Wert	Bedeutung
STYPE_DISKTREE	Laufwerk.
STYPE_PRINTQ	Druckwarteschlange.
STYPE_DEVICE	Kommunikationsgerät.
STYPE_IPC	Interprocess Communication (IPC).

Darüber hinaus können einer oder beide der folgenden Werte angegeben werden.

Wert	Bedeutung
STYPE_SPECIAL	Spezielle Freigabe, die für die prozessübergreifende Kommunikation (IPC$) oder die Remoteverwaltung des Servers (ADMIN$) reserviert ist. Kann auch auf Administrative Freigaben wie C$, D$, E$ usw. verweisen. Weitere Informationen finden Sie unter Netzwerkfreigabefunktionen.
STYPE_TEMPORARY	Eine temporäre Freigabe.

shi2_remark

Zeiger auf eine Unicode-Zeichenfolge, die einen optionalen Kommentar zur freigegebenen Ressource enthält.

shi2_permissions

Gibt einen DWORD-Wert an, der die Berechtigungen der freigegebenen Ressource für Server angibt, die mit Sicherheit auf Freigabeebene ausgeführt werden. Ein Server, auf dem die Sicherheit auf Benutzerebene ausgeführt wird, ignoriert dieses Element. Bei diesem Member kann es sich um einen oder mehrere der folgenden Werte handeln. Aufrufe der NetShareSetInfo-Funktion ignorieren diesen Member.

Beachten Sie, dass Windows keine Sicherheit auf Freigabeebene unterstützt.

Wert	Bedeutung
ACCESS_READ	Berechtigung zum Lesen von Daten aus einer Ressource und standardmäßig zum Ausführen der Ressource.
ACCESS_WRITE	Berechtigung zum Schreiben von Daten in die Ressource.
ACCESS_CREATE	Berechtigung zum Erstellen einer instance der Ressource (z. B. einer Datei). Daten können während der Erstellung der Ressource in die Ressource geschrieben werden.
ACCESS_EXEC	Berechtigung zum Ausführen der Ressource.
ACCESS_DELETE	Berechtigung zum Löschen der Ressource.
ACCESS_ATRIB	Berechtigung zum Ändern der Attribute der Ressource (z. B. Datum und Uhrzeit der letzten Änderung einer Datei).
ACCESS_PERM	Berechtigung zum Ändern der Berechtigungen (Lesen, Schreiben, Erstellen, Ausführen und Löschen), die einer Ressource für einen Benutzer oder eine Anwendung zugewiesen sind.
ACCESS_ALL	Berechtigung zum Lesen, Schreiben, Erstellen, Ausführen und Löschen von Ressourcen sowie zum Ändern ihrer Attribute und Berechtigungen.

shi2_max_uses

Gibt einen DWORD-Wert an, der die maximale Anzahl gleichzeitiger Verbindungen angibt, die die freigegebene Ressource aufnehmen kann. Die Anzahl der Verbindungen ist unbegrenzt, wenn der in diesem Member angegebene Wert –1 ist.

shi2_current_uses

Gibt einen DWORD-Wert an, der die Anzahl der aktuellen Verbindungen mit der Ressource angibt. Aufrufe der NetShareSetInfo-Funktion ignorieren diesen Member.

shi2_path

Zeiger auf eine Unicode-Zeichenfolge, die den lokalen Pfad für die freigegebene Ressource angibt. Bei Datenträgern ist shi2_path der freigegebene Pfad. Bei Druckwarteschlangen ist shi2_path der Name der freigegebenen Druckwarteschlange. Aufrufe der NetShareSetInfo-Funktion ignorieren diesen Member.

shi2_passwd

Zeiger auf eine Unicode-Zeichenfolge, die das Kennwort der Freigabe angibt, wenn der Server mit Sicherheit auf Freigabeebene ausgeführt wird. Wenn der Server mit Sicherheit auf Benutzerebene ausgeführt wird, wird dieser Member ignoriert. Der shi2_passwd-Member darf nicht länger als SHPWLEN+1 Byte sein (einschließlich eines endenden NULL-Zeichens). Aufrufe der NetShareSetInfo-Funktion ignorieren diesen Member. Beachten Sie, dass Windows keine Sicherheit auf Freigabeebene unterstützt.

Anforderungen


Unterstützte Mindestversion (Client)	Windows XP [nur Desktop-Apps]
Unterstützte Mindestversion (Server)	Windows Server 2003 [nur Desktop-Apps]
Kopfzeile	lmshare.h (lm.h einschließen)

Weitere Informationen

Übersicht über die Netzwerkverwaltung

Netzwerkverwaltungsstrukturen

Netzwerkfreigabefunktionen