IRTC :: 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 FramesCallbackProc,
  [in]  LPVOID UserContext,
  [out] HBLOB  hErrorBlob
);

Paramètres

hInputBlob [ dans]

Handle vers l’objet BLOB qui spécifie la carte réseau à laquelle vous vous connectez et les informations de configuration pour cette connexion.

StatusCallbackProc [ dans]

Adresse de la fonction de rappel d’état de l’utilisateur, qui reçoit les mises à jour d’État, telles que les déclencheurs. Ce paramètre peut avoir la valeur null.

FramesCallbackProc [ dans]

Adresse de la fonction de rappel de frame de l’utilisateur, qui est utilisée pour recevoir des mises à jour d’État, telles que les déclencheurs. Ce paramètre peut avoir la valeur null.

UserContext [ dans]

Valeur passée lorsque l’état de l’utilisateur et la fonction de rappel de frame sont appelés. Si les deux fonctions de rappel sont spécifiées, elles doivent utiliser la même valeur de contexte utilisateur. La valeur de ce paramètre est généralement HWND ou un pointeur’This'.

hErrorBlob [ à]

Handle vers un objet BLOB d’erreur qui contient des informations supplémentaires sur l’erreur. Pour plus d’informations sur ce qui se trouve dans l’objet BLOB d’erreurs, consultez la section Notes en bas de cette rubrique.

Valeur de retour

Si cette 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 IRTC :: configure ) :

Code de retour Description
NMERR _ déjà _ connecté
Cette instance de l’objet COM NPP est déjà connectée au réseau.
_erreur de conversion d’objet BLOB NMERR _ _
L’objet BLOB de configuration est endommagé. Cette erreur est générée par l’appel de IRTC :: configure .
l' _ entrée d’objet BLOB NMERR _ _ n' _ _ existe pas
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 IRTC :: Connecter ou IRTC :: configure . Examinez l’objet BLOB d’erreur retourné par hErrorBlob pour déterminer quelle entrée est introuvable.
_objet BLOB NMERR _ non _ initialisé
La fonction CreateBlob n’a pas été appelée. Cette erreur est générée par l’appel de IRTC :: configure .
_chaîne d’objet BLOB NMERR _ _ non valide
La chaîne ne se termine pas par un caractère null. Cette erreur est générée par l’appel de IRTC :: configure .
_déclencheur NMERR non conforme _
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 IRTC :: configure .
NMERR _ _ objet blob non valide
L’objet spécifié dans hInputBlob n’est pas un objet BLOB. Cette erreur est générée par l’appel de IRTC :: configure .
NMERR _ _ de _ mémoire insuffisante
La mémoire nécessaire pour effectuer cette opération n’est pas disponible. Cette erreur est générée par l’appel de IRTC :: configure .
_délai d’expiration de NMERR
Le délai d’attente de la demande a expiré. Cette erreur est générée par l’appel de IRTC :: configure .
NMERR _ objet blob de niveau supérieur _
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 IRTC :: configure .

Notes

lorsque la méthode Connecter est appelée, le NPP appelle automatiquement la méthode IRTC :: configure à l’aide de l’objet BLOB fourni par hInputBlob. notez que les codes d’erreur retournés par l’appel à IRTC :: configure sont passés en retour et retournés par l’appel de IRTC :: 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 IRTC pour capturer des frames.

Lorsque vous appelez cette fonction, vous devez spécifier une fonction de rappel d’État ou de frame, même si elle agit uniquement comme un espace réservé.

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é dans hErrorBlob contient des informations d’erreur que le développeur ou l’application peut utiliser pour la résolution des problèmes. L’objet BLOB d’erreur retourné par 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. Par exemple, si _ l’entrée d’objet BLOB NMERR _ _ n' _ _ existe pas est retournée, l’entrée Moniteur réseau introuvable 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 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
Netmon. h
DLL
Ndisnpp.dll ;
Rmtnpp.dll

Voir aussi

IRTC

IRTC :: configure

IRTC ::D éconnecter

IRTC :: Start