NPGetCaps-Funktion (npapi.h)
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 |