NPGetCaps, fonction (npapi.h)

Renvoie 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-unes des valeurs nIndex provoquent un retour d’une constante. Toutefois, dans la plupart des cas, le paramètre nIndex spécifie quel 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 administratives que le fournisseur de réseau prend en charge. Il peut s’agir d’un ou de plusieurs des éléments suivants.

#####WNNC_CONNECTION Renvoie un masque qui indique les fonctions de connexion que le fournisseur de réseau prend en charge. Il peut s’agir d’un ou de plusieurs des éléments suivants.

#####WNNC_DIALOG Renvoie un masque qui indique quelles fonctions de la boîte de dialogue le fournisseur de réseau prend en charge. Il peut s’agir d’un ou de plusieurs des éléments suivants.

#####WNNC_ENUMERATION

Retourne un masque qui indique les étendues d’énumération, le cas échéant, prises en charge. Pour plus d’informations sur les étendues d’énumération, consultez la section Parameters de la rubrique de référence NPOpenEnum. Il peut s’agir d’un ou de plusieurs des éléments suivants.

Note Si WNNC_ENUMERATION retourne une masque de bits différente de zéro, vous savez que le fournisseur de réseau prend en charge NPOpenEnum et peut déduire que le fournisseur prend également en charge NPEnumResource et NPCloseEnum. Cela est dû au fait qu’un fournisseur de réseau prenant 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 faible 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 approprié peut entraîner le comportement des fonctions WNET de manière imprévisible.

Le type de réseau peut être l’un des éléments 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 Renvoie WNNC_SPEC_VERSION51. Les mots élevés et faibles de la valeur de retour contiennent les numéros de version principale et mineure 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 la période d’attente la plus longue spécifiée par tous les fournisseurs de réseau.

#####WNNC_USER Renvoie WNNC_USR_GETUSER si le fournisseur de 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 l’heure de début la plus longue retournée par les fournisseurs qu’il a appelés.

Spécifications

Voir aussi

NPLogonNotify

NPPasswordChangeNotify