NPGetCaps-Funktion (npapi.h)

  • Artikel

Gibt Informationen darüber zurück, welche Dienste im Netzwerk unterstützt werden.

Syntax

DWORD NPGetCaps(
       DWORD ndex
);

Parameter

ndex

Rückgabewert

Die NPGetCaps-Funktion gibt abhängig vom Wert des nIndex-Parameters entweder eine Konstante oder eine Bitmaske zurück. Einige der nIndex-Werte führen dazu, dass eine Konstante zurückgegeben wird. In den meisten Fällen gibt der nIndex-Parameter jedoch an, welche Dienste abgefragt werden sollen, und der zurückgegebene Wert ist eine Bitmaske, die angibt, welche Dienste in dieser Gruppe unterstützt werden. In diesen Fällen gibt ein Null-Rückgabewert an, dass keiner der Dienste in der Gruppe unterstützt wird.

Die folgende Liste zeigt die Werte, die nIndex enthalten kann, gefolgt von einer Beschreibung, was für diesen Wert zurückgegeben wird.

####WNNC_ADMIN Gibt eine Maske zurück, die angibt, welche verwaltungstechnischen Funktionen der Netzwerkanbieter unterstützt. Dies kann eine oder mehrere der folgenden Optionen sein.

Flag Unterstützte Funktion
WNNC_ADM_DIRECTORYNOTIFY NPDirectoryNotify
WNNC_ADM_GETDIRECTORYTYPE NPGetDirectoryType

####WNNC_CONNECTION Gibt eine Maske zurück, die angibt, welche der Verbindungsfunktionen vom Netzwerkanbieter unterstützt. Dies kann eine oder mehrere der folgenden Optionen sein.

Flag Unterstützte Funktion
WNNC_CON_ADDCONECTION (0x00000001) NPAddConnection
WNNC_CON_CANCELCONNECTION (0x00000002) NPCancelConnection
WNNC_CON_GETCONNECTIONS (0x00000004) NPGetConnection
WNNC_CON_ADDCONECTION3 (0x00000008) NPAddConnection3
WNNC_CON_GETPERFORMANCE (0x00000040) NPGetConnectionPerformance
WNNC_CON_DEFER (0x00000080) Verzögerte Verbindungen werden mit NPAddConnection3 unterstützt.

####WNNC_DIALOG Gibt eine Maske zurück, die angibt, welche der Funktionen des Dialogfelds vom Netzwerkanbieter unterstützt. Dies kann eine oder mehrere der folgenden Optionen sein.

Flag Unterstützte Funktion
WNNC_DLG_DEVICEMODE NPDeviceMode
WNNC_DLG_FORMATNETNAME NPFormatNetworkName
WNNC_DLG_GETRESOURCEINFORMATION NPGetResourceInformation
WNNC_DLG_GETRESOURCEPARENT NPGetResourceParent
WNNC_DLG_PERMISSIONEDITOR Dieses Flag wird nicht verwendet.
WNNC_DLG_PROPERTYDIALOG NPPropertyDialog und NPGetPropertyText
WNNC_DLG_SEARCHDIALOG NPSearchDialog

####WNNC_ENUMERATION

Gibt eine Maske zurück, die angibt, welche Enumerationsbereiche ggf. unterstützt werden. Weitere Informationen zu Enumerationsbereichen finden Sie im Abschnitt Parameter des Referenzthemas NPOpenEnum. Dies kann eine oder mehrere der folgenden Optionen sein.

Flag Unterstützter Enumerationstyp
WNNC_ENUM_GLOBAL (0x00000001) NPOpenEnum ist implementiert und unterstützt einen Bereich aller Ressourcen im Netzwerk. Mit anderen Worten: NPOpenEnum unterstützt RESOURCE_GLOBALNET.
WNNC_ENUM_LOCAL (0x00000002) NPOpenEnum ist implementiert und unterstützt einen Bereich aller derzeit verbundenen Ressourcen. Mit anderen Worten: NPOpenEnum unterstützt RESOURCE_CONNECTED.
WNNC_ENUM_CONTEXT (0x00000004) NPOpenEnum ist implementiert und unterstützt einen Bereich aller Ressourcen, die dem aktuellen und dem Standardnetzwerkkontext des Benutzers zugeordnet sind. Mit anderen Worten: NPOpenEnum unterstützt RESOURCE_CONTEXT.

Hinweis Wenn WNNC_ENUMERATION eine Bitmaske ungleich null zurückgibt, wissen Sie, dass der Netzwerkanbieter NPOpenEnum unterstützt, und sie können daraus ableiten, dass der Anbieter auch NPEnumResource und NPCloseEnum unterstützt. Dies liegt daran, dass ein Netzwerkanbieter, der NPOpenEnum unterstützt, auch NPEnumResource und NPCloseEnum unterstützt.

####WNNC_NET_TYPE Gibt einen Wert zurück, der den Vom Netzwerkanbieter unterstützten Netzwerktyp angibt. Das hohe Wort enthält den Anbietertyp, und das niedrige Wort kann einen Untertyp enthalten. Entwickler, die an neuen Anbietern arbeiten, sollten einen neuen Netzwerktyp von Microsoft erhalten. Ein Anbieter, der nicht den richtigen Netzwerktyp zurückgibt, kann dazu führen, dass sich die WNET-Funktionen auf unvorhersehbare Weise verhalten.

Der Netzwerktyp kann einer der folgenden Sein:

  • WNNC_NET_10NET
  • WNNC_NET_INTERGRAPH
  • WNNC_NET_3IN1
  • WNNC_NET_LANMAN
  • WNNC_NET_9TILES
  • WNNC_NET_LANSTEP
  • WNNC_NET_APPLETALK
  • WNNC_NET_LANTASTIC
  • WNNC_NET_AS400
  • WNNC_NET_LIFENET
  • WNNC_NET_BMC
  • WNNC_NET_LOCUS
  • WNNC_NET_BWNFS
  • WNNC_NET_MASFAX
  • WNNC_NET_CLEARCASE
  • WNNC_NET_MSNET
  • WNNC_NET_COGENT
  • WNNC_NET_NETWARE
  • WNNC_NET_CSC
  • WNNC_NET_OBJECT_DIRE
  • WNNC_NET_DCE
  • WNNC_NET_PATHWORKS
  • WNNC_NET_DECOREB
  • WNNC_NET_POWERLAN
  • WNNC_NET_DISTENCT
  • WNNC_NET_PROTSTOR
  • WNNC_NET_EXTENDNET
  • WNNC_NET_RDR2SAMPLE
  • WNNC_NET_FARALLON
  • WNNC_NET_SHIVA
  • WNNC_NET_FJ REDIR
  • WNNC_NET_SUN_PC_NFS
  • WNNC_NET_FRONTIER
  • WNNC_NET_SYMFONET
  • WNNC_NET_FTP_NFS
  • WNNC_NET_TWINS
  • WNNC_NET_HOB_NFS
  • WNNC_NET_VINES
  • WNNC_NET_IBMAL

####WNNC_SPEC_VERSION Gibt WNNC_SPEC_VERSION51 zurück. Die wörter "hoch" und "low" des Rückgabewerts enthalten die Haupt- und Nebenversionsnummern der WNet-API-Spezifikation, die vom Anmeldeinformations-Manager unterstützt werden.

####WNNC_START Gibt einen der folgenden Werte zurück, um anzugeben, ob und wann der Anbieter wahrscheinlich gestartet wird. Der MPR wartet auf den längsten Timeoutzeitraum, der von allen Netzwerkanbietern angegeben wird.

Flag Startzeit
0x0 Gibt an, dass der Anbieter nicht gestartet wird, z. B. wenn er deaktiviert ist. Der MPR versucht nicht, den Netzwerkanbieter zu starten.
Time Gibt die Zeit in Millisekunden an, bis der Anbieter gestartet wird.
0xFFFFFFFF Gibt an, dass der Anbieter nicht weiß, wann er gestartet wird. Wenn der Netzwerkanbieter diesen Wert zurückgibt, verwendet der MPR den Standardwert 60 Sekunden.
0x1 Gibt an, dass der Anbieter bereits gestartet wurde.

####WNNC_USER Gibt WNNC_USR_GETUSER zurück, wenn der Netzwerkanbieter die NPGetUser-Funktion unterstützt.

Hinweise

Wenn eine Startzeit von NPGetCaps zurückgegeben wird, verwendet der MPR diesen Wert, um zu bestimmen, wann versucht werden soll, alle Netzwerkanbieter erneut zu starten. MPR verwendet die längste Startzeit, die von den aufgerufenen Anbietern zurückgegeben wird.

Anforderungen

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

Weitere Informationen

NPLogonNotify

NPPasswordChangeNotify