Freigeben über

NETRESOURCEA-Struktur (winnetwk.h)

  • Artikel

Die folgende Struktur enthält Informationen zu einer Netzwerkressource. Es wird von mehreren der 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;

Angehörige

dwScope

Gibt den Bereich der Aufzählung 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 gemeinsam genutzter Drucker.
RESOURCETYPE_ANY
 Die Ressource entspricht mehreren Typen, z. B. einem Container mit Druck- und Datenträgerressourcen oder einer Ressource, die weder gedruckt noch datenträgerseitig ist.

dwDisplayType

Legen Sie den Anbieter fest, um anzugeben, welchen Anzeigetyp eine Benutzeroberfläche verwenden soll, um diese Ressource darzustellen. Die folgenden Typen werden 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 aufzählen können. Sie wird nur definiert, wenn dwScope- auf RESOURCE_GLOBALNET festgelegt ist. Das dwUsage- Felds kann ein oder mehrere der folgenden Flags enthalten.

Wert Bedeutung
RESOURCEUSAGE_CONNECTABLE
 Sie können eine Verbindung mit der Ressource herstellen, indem Sie NPAddConnectionaufrufen. 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 zu enumerieren, die die Ressource enthält.
RESOURCEUSAGE_CONTAINER
 Die Ressource ist ein Container für andere Ressourcen, die mithilfe der NPOpenEnum-, NPEnumResource-und NPCloseEnum--Funktionen aufgezählt werden können.

Der Container kann jedoch zum Zeitpunkt der Aufzählung leer sein. Mit anderen Worten, 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 es sich bei der Verbindung um eine gerätelose Verbindung handelt, 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 aufgezählte Element eine aktuelle Verbindung ist, verweist dieses Feld auf den Remotenetzwerknamen, mit dem lpLocalName verbunden ist.

lpComment

Es kann sich um jeden vom Anbieter bereitgestellten Kommentar handeln, der dem aufgezählten Element zugeordnet ist.

lpProvider

Gibt den Namen des Anbieters an, der dieses aufgezählte Element besitzt.

Bemerkungen

Anmerkung

Der winnetwk.h-Header definiert NETRESOURCE als Alias, der automatisch die ANSI- oder Unicode-Version dieser Funktion basierend auf der Definition der UNICODE-Präprozessorkonstante 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

Anforderung Wert
mindestens unterstützte Client- Windows XP [nur Desktop-Apps]
mindestens unterstützte Server- Windows Server 2003 [Nur Desktop-Apps]
Header- winnetwk.h