Fonction NPGetCaps (npapi.h)
Retourne des informations sur les services pris en charge sur le réseau.
Syntaxe
DWORD NPGetCaps(
DWORD ndex
);
Paramètres
ndex
Valeur retournée
La fonction NPGetCaps retourne une constante ou un masque de bits, en fonction de la valeur du paramètre nIndex . Quelques valeurs nIndex provoquent le retour d’une constante. Toutefois, dans la plupart des cas, le paramètre nIndex spécifie l’ensemble de services à interroger, et la valeur retournée est un masque de bits qui indique quels services de cet ensemble sont pris en charge. Dans ce cas, une valeur de retour zéro indique qu’aucun des services de l’ensemble n’est pris en charge.
La liste suivante montre les valeurs que nIndex peut contenir, chacune suivie d’une description de ce qui est retourné pour cette valeur.
####WNNC_ADMIN Renvoie un masque qui indique les fonctions d’administration que le fournisseur réseau prend en charge. Il peut s’agir de l’un ou plusieurs des éléments suivants.
| Indicateur | Fonction prise en charge |
|---|---|
| WNNC_ADM_DIRECTORYNOTIFY | NPDirectoryNotify |
| WNNC_ADM_GETDIRECTORYTYPE | NPGetDirectoryType |
####WNNC_CONNECTION Renvoie un masque qui indique les fonctions de connexion que le fournisseur de réseau prend en charge. Il peut s’agir de l’un ou plusieurs des éléments suivants.
| Indicateur | Fonction prise en charge |
|---|---|
| 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) | Les connexions différées sont prises en charge avec NPAddConnection3. |
####WNNC_DIALOG Renvoie un masque qui indique les fonctions de boîte de dialogue que le fournisseur réseau prend en charge. Il peut s’agir de l’un ou plusieurs des éléments suivants.
| Indicateur | Fonction prise en charge |
|---|---|
| WNNC_DLG_DEVICEMODE | NPDeviceMode |
| WNNC_DLG_FORMATNETNAME | NPFormatNetworkName |
| WNNC_DLG_GETRESOURCEINFORMATION | NPGetResourceInformation |
| WNNC_DLG_GETRESOURCEPARENT | NPGetResourceParent |
| WNNC_DLG_PERMISSIONEDITOR | Cet indicateur n’est pas utilisé. |
| WNNC_DLG_PROPERTYDIALOG | NPPropertyDialog et NPGetPropertyText |
| WNNC_DLG_SEARCHDIALOG | NPSearchDialog |
####WNNC_ENUMERATION
Retourne un masque qui indique quelles étendues d’énumération, le cas échéant, sont prises en charge. Pour plus d’informations sur les étendues d’énumération, consultez la section Paramètres de la rubrique de référence NPOpenEnum. Il peut s’agir de l’un ou plusieurs des éléments suivants.
| Indicateur | Type d’énumération pris en charge |
|---|---|
| WNNC_ENUM_GLOBAL (0x00000001) | NPOpenEnum est implémenté et prend en charge une étendue de toutes les ressources sur le réseau. En d’autres termes, NPOpenEnum prend en charge RESOURCE_GLOBALNET. |
| WNNC_ENUM_LOCAL (0x00000002) | NPOpenEnum est implémenté et prend en charge une étendue de toutes les ressources actuellement connectées. En d’autres termes, NPOpenEnum prend en charge RESOURCE_CONNECTED. |
| WNNC_ENUM_CONTEXT (0x00000004) | NPOpenEnum est implémenté et prend en charge une étendue de toutes les ressources associées au contexte réseau actuel et par défaut de l’utilisateur. En d’autres termes, NPOpenEnum prend en charge RESOURCE_CONTEXT. |
Note Si WNNC_ENUMERATION retourne un masque de bits différent de zéro, vous savez que le fournisseur réseau prend en charge NPOpenEnum et peut en déduire que le fournisseur prend également en charge NPEnumResource et NPCloseEnum. En effet, un fournisseur réseau qui prend en charge NPOpenEnum est également censé prendre en charge NPEnumResource et NPCloseEnum.
####WNNC_NET_TYPE Renvoie une valeur qui indique le type de réseau pris en charge par le fournisseur de réseau. Le mot élevé contient le type de fournisseur, et le mot bas peut contenir un sous-type. Les développeurs qui travaillent sur de nouveaux fournisseurs doivent obtenir un nouveau type de réseau auprès de Microsoft. Un fournisseur qui ne retourne pas le type de réseau correct peut entraîner un comportement imprévisible des fonctions WNET.
Le type de réseau peut être l’un des suivants.
- 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 retourne WNNC_SPEC_VERSION51. Les mots hauts et bas de la valeur de retour contiennent les numéros de version principale et secondaire de la spécification de l’API WNet prise en charge par le gestionnaire d’informations d’identification.
####WNNC_START Renvoie l’une des valeurs suivantes pour indiquer si et quand le fournisseur est susceptible de démarrer. Le mpr attend le délai d’expiration le plus long spécifié par tous les fournisseurs de réseau.
| Indicateur | Heure de début |
|---|---|
| 0x0 | Indique que le fournisseur ne démarrera pas, par exemple s’il est désactivé. Le MPR ne réessayera pas de démarrer le fournisseur réseau. |
| Temps | Indique le temps, en millisecondes, jusqu’au démarrage du fournisseur. |
| 0xFFFFFFFF | Indique que le fournisseur ne sait pas quand il démarrera. Si le fournisseur réseau retourne cette valeur, le MPR utilise sa valeur par défaut, 60 secondes. |
| 0x1 | Indique que le fournisseur est déjà démarré. |
####WNNC_USER Renvoie WNNC_USR_GETUSER si le fournisseur réseau prend en charge la fonction NPGetUser .
Remarques
Lorsqu’une heure de début est retournée par NPGetCaps, le MPR utilise cette valeur pour déterminer quand essayer de redémarrer tous les fournisseurs réseau. MPR utilise le temps de début le plus long retourné par les fournisseurs qu’il a appelés.
Configuration requise
| Condition requise | Valeur |
|---|---|
| Client minimal pris en charge | Windows XP [applications de bureau uniquement] |
| Serveur minimal pris en charge | Windows Server 2003 [applications de bureau uniquement] |
| Plateforme cible | Windows |
| En-tête | npapi.h |