SHARE_INFO_503-Struktur (lmshare.h)

Artikel
08/24/2023

Enthält Informationen zur freigegebenen Ressource. Sie ist identisch mit der SHARE_INFO_502-Struktur , mit der Ausnahme, dass sie auch den Servernamen enthält.

Syntax

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

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

shi503_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 0x00000000	Laufwerk.
STYPE_PRINTQ 0x00000001	Druckwarteschlange.
STYPE_DEVICE 0x00000002	Kommunikationsgerät.
STYPE_IPC 0x00000003	Interprocess Communication (IPC).

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

Wert	Bedeutung
STYPE_SPECIAL 0x80000000	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 0x40000000	Eine temporäre Freigabe.

shi503_remark

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

shi503_permissions

Gibt einen DWORD-Wert an, der die Berechtigungen der freigegebenen Ressource für Server angibt, die mit Sicherheit auf Freigabeebene ausgeführt werden. Beachten Sie, dass Windows die Sicherheit auf Freigabeebene nicht unterstützt. Dieser Member wird auf einem Server ignoriert, auf dem Sicherheit auf Benutzerebene ausgeführt wird. Weitere Informationen zum Steuern des Zugriffs auf sicherungsfähige Objekte finden Sie unter Access Control, Berechtigungen und Sicherungsobjekte.

Aufrufe der NetShareSetInfo-Funktion ignorieren diesen Member.

Bei diesem Member kann es sich um einen der folgenden Werte handeln.

Wert	Bedeutung
ACCESS_READ 0x00000001	Berechtigung zum Lesen von Daten aus einer Ressource und standardmäßig zum Ausführen der Ressource.
ACCESS_WRITE 0x00000002	Berechtigung zum Schreiben von Daten in die Ressource.
ACCESS_CREATE 0x00000004	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 0x00000008	Berechtigung zum Ausführen der Ressource.
ACCESS_DELETE 0x00000010	Berechtigung zum Löschen der Ressource.
ACCESS_ATRIB 0x00000020	Berechtigung zum Ändern der Attribute der Ressource (z. B. Datum und Uhrzeit der letzten Änderung einer Datei).
ACCESS_PERM 0x00000040	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 0x00008000	Berechtigung zum Lesen, Schreiben, Erstellen, Ausführen und Löschen von Ressourcen sowie zum Ändern ihrer Attribute und Berechtigungen.

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

shi503_current_uses

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

shi503_path

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

shi503_passwd

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

shi503_servername

Ein Zeiger auf eine Zeichenfolge, die den DNS- oder NetBIOS-Namen des Remoteservers angibt, auf dem sich die freigegebene Ressource befindet. Der Wert "*" gibt keinen konfigurierten Servernamen an.

shi503_reserved

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

shi503_security_descriptor

Gibt die SECURITY_DESCRIPTOR an, die dieser Freigabe zugeordnet sind.

Hinweise

Der im shi503_servername-Member angegebene Remoteserver muss mithilfe der NetServerTransportAddEx-Funktion an ein Transportprotokoll gebunden worden sein. Beim Aufruf von NetServerTransportAddEx muss entweder 2 oder 3 für den level-Parameter angegeben worden sein, und der SVTI2_SCOPED_NAME Wert muss in der SERVER_TRANSPORT_INFO_2-Struktur für das Transportprotokoll angegeben worden sein.

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)