Share via

Fonction NPGetCaps (npapi.h)

  • Article

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

Voir aussi

NPLogonNotify

NPPasswordChangeNotify