NETRESOURCEA-Struktur (winnetwk.h)

Artikel
08/27/2023

Die folgende Struktur enthält Informationen zu einer Netzwerkressource. Es wird von mehreren Netzwerkanbieterfunktionen verwendet, einschließlich NPOpenEnum und NPAddConnection.

Syntax

typedef struct _NETRESOURCEA {
  DWORD dwScope;
  DWORD dwType;
  DWORD dwDisplayType;
  DWORD dwUsage;
  LPSTR lpLocalName;
  LPSTR lpRemoteName;
  LPSTR lpComment;
  LPSTR lpProvider;
} NETRESOURCEA, *LPNETRESOURCEA;

Member

dwScope

Gibt den Bereich der Enumeration an. Dies kann einer der folgenden Werte sein.

Wert	Bedeutung
RESOURCE_CONNECTED	Aktuelle Verbindungen mit Netzwerkressourcen.
RESOURCE_GLOBALNET	Alle Netzwerkressourcen. Diese können verbunden sein oder nicht.
RESOURCE_CONTEXT	Die Netzwerkressourcen, die dem aktuellen und dem Standardnetzwerkkontext des Benutzers zugeordnet sind. Die Bedeutung ist anbieterspezifisch.

dwType

Gibt den Ressourcentyp an. Dies kann einer der folgenden Werte sein.

Wert	Bedeutung
RESOURCETYPE_DISK	Die Ressource ist ein freigegebenes Datenträgervolume.
RESOURCETYPE_PRINT	Die Ressource ist ein freigegebener Drucker.
RESOURCETYPE_ANY	Die Ressource entspricht mehr als einem Typ, z. B. einem Container mit Druck- und Datenträgerressourcen oder einer Ressource, die weder print noch datenträger ist.

dwDisplayType

Legen Sie vom Anbieter fest, um anzugeben, welchen Anzeigetyp eine Benutzeroberfläche verwenden soll, um diese Ressource darzustellen. Die folgenden Typen sind definiert.

Wert	Bedeutung
RESOURCEDISPLAYTYPE_NETWORK	Die Ressource ist ein Netzwerkanbieter.
RESOURCEDISPLAYTYPE_DOMAIN	Die Ressource ist eine Sammlung von Servern.
RESOURCEDISPLAYTYPE_SERVER	Die Ressource ist ein Server.
RESOURCEDISPLAYTYPE_SHARE	Die Ressource ist ein Freigabepunkt.
RESOURCEDISPLAYTYPE_DIRECTORY	Die Ressource ist ein Verzeichnis.
RESOURCEDISPLAYTYPE_GENERIC	Der Ressourcentyp ist nicht angegeben. Dieser Wert wird von Netzwerkanbietern verwendet, die keine Ressourcentypen angeben.

dwUsage

Eine Bitmaske, die angibt, wie Sie Informationen zur Ressource auflisten können. Sie wird nur definiert, wenn dwScope auf RESOURCE_GLOBALNET festgelegt ist. Das Feld dwUsage kann eines oder mehrere der folgenden Flags enthalten.

Wert	Bedeutung
RESOURCEUSAGE_CONNECTABLE	Sie können eine Verbindung mit der Ressource herstellen, indem Sie NPAddConnection aufrufen. Wenn dwType RESOURCETYPE_DISK ist, können Sie, nachdem Sie eine Verbindung mit der Ressource hergestellt haben, die Dateisystem-APIs wie FindFirstFile und FindNextFile verwenden, um alle Dateien und Verzeichnisse aufzulisten, die die Ressource enthält.
RESOURCEUSAGE_CONTAINER	Die Ressource ist ein Container für andere Ressourcen, die mithilfe der Funktionen NPOpenEnum, NPEnumResource und NPCloseEnum aufgezählt werden können. Der Container kann jedoch zum Zeitpunkt der Enumeration leer sein. Anders ausgedrückt: Der erste Aufruf von NPEnumResource kann WN_NO_MORE_ENTRIES zurückgeben.

lpLocalName

Wenn dwScope RESOURCE_CONNECTED ist, enthält das Feld lpLocalName den Namen eines umgeleiteten Geräts. Wenn die Verbindung eine gerätelose Verbindung ist, enthält dieses Feld NULL.

Wenn dwScope nicht auf RESOURCE_CONNECTED festgelegt ist, ist dieses Feld nicht definiert.

lpRemoteName

Wenn das aufgezählte Element eine Netzwerkressource ist, enthält dieses Feld einen Remotenetzwerknamen. Dieser Name kann dann an NPAddConnection übergeben werden, um eine Netzwerkverbindung herzustellen, wenn dwUsage auf RESOURCEUSAGE_CONNECTABLE festgelegt ist. Wenn das enumerierte Element eine aktuelle Verbindung ist, verweist dieses Feld auf den Namen des Remotenetzwerks, mit dem lpLocalName verbunden ist.

lpComment

Kann ein vom Anbieter bereitgestellter Kommentar sein, der dem aufgezählten Element zugeordnet ist.

lpProvider

Gibt den Namen des Anbieters an, der dieses enumerationierte Element besitzt.

Hinweise

Hinweis

Der winnetwk.h-Header definiert NETRESOURCE als Alias, der die ANSI- oder Unicode-Version dieser Funktion basierend auf der Definition der UNICODE-Präprozessorkonstante automatisch auswählt. Das Mischen der Verwendung des codierungsneutralen Alias mit Code, der nicht Codierungsneutral ist, kann zu Nichtübereinstimmungen führen, die zu Kompilierungs- oder Laufzeitfehlern führen. Weitere Informationen finden Sie unter Konventionen für Funktionsprototypen.

Anforderungen


Unterstützte Mindestversion (Client)	Windows XP [nur Desktop-Apps]
Unterstützte Mindestversion (Server)	Windows Server 2003 [nur Desktop-Apps]
Kopfzeile	winnetwk.h

Share via