Freigeben über

NETRESOURCEA-Struktur (winnetwk.h)

  • Artikel

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