NPGetCaps-Funktion (npapi.h)

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

Syntax

DWORD NPGetCaps(
       DWORD ndex
);

Die 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, welcher Satz von Diensten abgefragt werden soll, und der zurückgegebene Wert ist eine Bitmaske, die angibt, welche Dienste in diesem Satz unterstützt werden. In diesen Fällen gibt ein Null-Rückgabewert an, dass keine der Dienste im Satz unterstützt wird.

In der folgenden Liste sind die Werte aufgeführt, 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 administrativen Funktionen der Netzwerkanbieter unterstützt. Dies kann eine oder mehrere der folgenden Aktionen sein:

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

#####WNNC_DIALOG Gibt eine Maske zurück, die angibt, welche der Dialogfelder vom Netzwerkanbieter unterstützt. Dies kann eine oder mehrere der folgenden Aktionen sein:

####WNNC_ENUMERATION

Gibt eine Maske zurück, die angibt, welche Enumerationsbereiche (falls vorhanden) unterstützt werden. Weitere Informationen zu Enumerationsbereichen finden Sie im Abschnitt "Parameters" im Referenzthema NPOpenEnum. Dies kann eine oder mehrere der folgenden Aktionen sein:

Anmerkung Wenn WNNC_ENUMERATION eine Bitmaske ungleich Null zurückgibt, wissen Sie, dass der Netzwerkanbieter NPOpenEnum unterstützt und ableiten kann, 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 den richtigen Netzwerktyp nicht zurückgibt, kann dazu führen, dass sich die WNET-Funktionen auf unvorhersehbare Weise verhalten.

Der Netzwerktyp kann eine 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 hohen und niedrigen Wörter 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.

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

Bemerkungen

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

Anforderungen

Siehe auch

NPLogonNotify

NPPasswordChangeNotify