NETRESOURCEW-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 _NETRESOURCEW {
  DWORD  dwScope;
  DWORD  dwType;
  DWORD  dwDisplayType;
  DWORD  dwUsage;
  LPWSTR lpLocalName;
  LPWSTR lpRemoteName;
  LPWSTR lpComment;
  LPWSTR lpProvider;
} NETRESOURCEW, *LPNETRESOURCEW;

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 ders 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 gedruckt 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 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 auflisten können. Sie wird nur definiert, wenn dwScope auf RESOURCE_GLOBALNET festgelegt ist. Das Feld dwUsage kann mindestens eins 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 nach der Verbindung mit der Ressource 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 Aufzählung 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 es sich bei dem aufgezählten Element um eine Netzwerkressource handelt, 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

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

lpProvider

Gibt den Namen des Anbieters an, der dieses aufgezählte 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 nicht codierungsneutralem Code 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
Unterstützte Mindestversion (Client)	Windows XP [nur Desktop-Apps]
Unterstützte Mindestversion (Server)	Windows Server 2003 [nur Desktop-Apps]
Kopfzeile	winnetwk.h

Freigeben über