IStats :: Connecter, méthode
la méthode Connecter connecte le NPP au réseau à l’aide d’une carte réseau spécifiée et fournit des informations de configuration pour la connexion.
Syntaxe
HRESULT STDMETHODCALLTYPE Connect(
[in] HBLOB hInputBlob,
[in] LPVOID StatusCallbackProc,
[in] LPVOID UserContext,
[out] HBLOB hErrorBlob
);
Paramètres
-
hInputBlob [ dans]
-
Handle vers l’objet BLOB qui spécifie la carte réseau à laquelle le NPP se connecte et les informations de configuration pour cette connexion.
-
StatusCallbackProc [ dans]
-
Adresse de la fonction de rappel de l’utilisateur, qui reçoit les mises à jour d’État, telles que les déclencheurs. Si aucune fonction de rappel n’est utilisée, définissez ce paramètre et le paramètre userContext sur la valeur null.
-
UserContext [ dans]
-
Valeur passée lorsque la fonction de rappel de l’utilisateur est appelée. La valeur de ce paramètre est généralement HWND ou un pointeur’This'. Si aucune fonction de rappel n’est spécifiée, affectez la valeur null à ce paramètre et au paramètre StatusCallbackProc .
-
hErrorBlob [ à]
-
Handle vers un objet BLOB d’erreur qui contient des informations supplémentaires sur l’erreur.
Valeur de retour
Si la méthode réussit, la valeur de retour est NMERR _ Success.
Si la méthode échoue, la valeur de retour est l’un des codes d’erreur suivants (qui incluent les erreurs retournées par l’appel Internal IStats :: configure ) :
| Code de retour | Description |
|---|---|
|
Cette instance de l’objet COM NPP est déjà connectée au réseau. |
|
L’objet BLOB de configuration est endommagé. Cette erreur est générée par l’appel de IStats :: configure . |
|
L’objet BLOB d’entrée spécifié par le paramètre hInputBlob n’a pas d’entrée nécessaire pour effectuer cette opération. cette erreur peut être générée par l’appel de IStats :: Connecter ou IStats :: configure . Examinez l’objet BLOB d’erreur retourné par hErrorBlob pour déterminer quelle entrée est introuvable. |
|
La fonction CreateBlob n’a pas été appelée. Cette erreur est générée par l’appel de IStats :: configure . |
|
La chaîne ne se termine pas par un caractère null. Cette erreur est générée par l’appel de IStats :: configure . |
|
La partie déclencheur de l’objet BLOB d’entrée est endommagée. Cette erreur est générée par l’appel de IStats :: configure . |
|
L’objet spécifié dans hInputBlob n’est pas un objet BLOB. Cette erreur est générée par l’appel de IStats :: configure . |
|
Le répertoire de capture par défaut n’a pas été défini dans le registre. Pour définir le répertoire de capture, utilisez le chemin d’accès suivant. |
|
La mémoire requise pour effectuer cette opération n’était pas disponible. Cette erreur est générée par l’appel de IStats :: configure . |
|
Le délai d’attente de la demande a expiré. Cette erreur est générée par l’appel de IStats :: configure . |
|
Le numéro de version de l’objet BLOB spécifié dans hInputBlob est incorrect. Cette erreur est générée par l’appel de IStats :: configure . |
Notes
lorsque la méthode Connecter est appelée, Moniteur réseau appelle automatiquement la méthode IStats :: configure à l’aide de l’objet BLOB fourni par le paramètre hInputBlob . notez que les codes d’erreur retournés par l’appel à IStats :: configure sont passés en retour et retournés par l’appel de IStats :: Connecter .
Cette méthode doit être appelée avant que vous ne puissiez commencer à capturer des frames. Notez que lorsque vous vous connectez au réseau à l’aide de cette méthode, vous devez continuer à utiliser l’interface IStats pour capturer des frames.
L’objet BLOB d’entrée spécifié par hInputBlob peut être obtenu en appelant les méthodes GetNPPBlobFromUI, GetNPPBlobTable et SelectNPPBlobFromTable .
L’objet BLOB d’erreur retourné par le paramètre hErrorBlob contient des entrées que Moniteur réseau n’a pas pu comprendre ou trouver dans l’objet blob d’entrée spécifié dans hInputBlob. L’objet BLOB d’erreurs renvoyé contient des informations d’erreur que l’application peut utiliser pour la résolution des problèmes. Par exemple, si l' _ entrée d’objet BLOB NMERR _ _ n' _ _ existe pas est retournée, l’entrée que Moniteur réseau n’a pas pu trouver est incluse dans l’objet blob d’erreur retourné.
| Pour obtenir des informations sur | Consultez |
|---|---|
| Obtention de l’objet BLOB d’entrée qui représente une carte d’interface réseau | Sélection d’une carte d’interface réseau |
Spécifications
| Condition requise | Valeur |
|---|---|
| Client minimal pris en charge |
Windows 2000 Professionnel - [Applications de bureau uniquement] |
| Serveur minimal pris en charge |
Windows 2000 Server - [Applications de bureau uniquement] |
| En-tête |
|
| DLL |
|