SHARE_INFO_502 Struktur (lmshare.h)

Artikel
08/24/2023

Enthält Informationen zur freigegebenen Ressource, einschließlich Name der Ressource, Typ und Berechtigungen, Anzahl der Verbindungen und andere relevante Informationen.

Syntax

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;

Member

shi502_netname

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

shi502_type

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

Einer der folgenden Werte kann angegeben werden. Sie können diese Werte isolieren, indem Sie den wert STYPE_MASK verwenden.

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

shi502_remark

Zeiger auf eine Unicode-Zeichenfolge, die einen optionalen Kommentar zur freigegebenen Ressource angibt.

shi502_permissions

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

Beachten Sie, dass Windows die Sicherheit auf Freigabeebene nicht unterstützt. Weitere Informationen zum Steuern des Zugriffs auf sicherungsfähige Objekte finden Sie unter Access Control, Berechtigungen und Sicherungsobjekte.

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 eines instance der Ressource (z. B. einer Datei); Daten können beim Erstellen 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.

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

shi502_current_uses

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

shi502_path

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

shi502_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. Beachten Sie, dass Windows die Sicherheit auf Freigabeebene nicht unterstützt.

Dieser Member darf nicht länger als SHPWLEN+1 Bytes sein (einschließlich eines endenden NULL-Zeichens). Aufrufe der NetShareSetInfo-Funktion ignorieren diesen Member.

shi502_reserved

Reserviert; muss null sein. Aufrufe der NetShareSetInfo-Funktion ignorieren diesen Member.

shi502_security_descriptor

Gibt die SECURITY_DESCRIPTOR an, die dieser Freigabe zugeordnet sind.

Anforderungen

Anforderung	Wert
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