Méthode IESP::Connect

Article
06/13/2023

La méthode Connect connecte le NPP au réseau à l’aide d’une carte réseau spécifiée et fournit des informations de configuration sur la connexion.

Syntaxe

HRESULT STDMETHODCALLTYPE Connect(
  [in]  HBLOB hInputBlob,
  [in]  DWORD StatusCallbackProc,
  [in]  DWORD UserContext,
  [out] HBLOB hErrorBlob
);

Paramètres

hInputBlob [in]: Gérez l’objet BLOB qui spécifie la carte réseau à laquelle le NPP se connecte et les informations de configuration de cette connexion.
StatusCallbackProc [in]: Adresse de la fonction de rappel de l’utilisateur, qui reçoit des mises à jour status telles que des déclencheurs. Si aucune fonction de rappel n’est utilisée, définissez ce paramètre et le paramètre UserContext sur NULL.
UserContext [in]: 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, définissez ce paramètre et le paramètre StatusCallbackProc sur NULL.
hErrorBlob [out]: Gérez un objet BLOB d’erreur qui contient des informations d’erreur supplémentaires.

Valeur retournée

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 IESP::Configure interne) :

Code de retour	Description
NMERR_ALREADY_CONNECTED	Cette instance de l’objet COM NPP est déjà connectée au réseau.
NMERR_BLOB_CONVERSION_ERROR	L’objet BLOB de configuration est endommagé. Cette erreur est générée par l’appel IESP::Configure .
NMERR_BLOB_ENTRY_DOES_NOT_EXIST	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 IESP::Connect ou IESP::Configure . Examinez l’objet BLOB d’erreur retourné par hErrorBlob pour déterminer l’entrée introuvable.
NMERR_BLOB_NOT_INITIALIZED	La fonction CreateBlob n’a pas été appelée. Cette erreur est générée par l’appel IESP::Configure .
NMERR_BLOB_STRING_INVALID	La chaîne n’est pas terminée par null. Cette erreur est générée par l’appel IESP::Configure .
NMERR_ILLEGAL_TRIGGER	La partie déclencheur de l’objet BLOB d’entrée est endommagée. Cette erreur est générée par l’appel IESP::Configure .
NMERR_INVALID_BLOB	L’objet spécifié dans hInputBlob n’est pas un objet BLOB. Cette erreur est générée par l’appel IESP::Configure .
NMERR_NO_DEFAULT_CAPTURE_DIRECTORY	Le répertoire de capture par défaut n’a pas été défini dans le Registre. Utilisez le chemin d’accès suivant pour définir le répertoire de capture. `HKEY_LOCAL_MACHINE\System\CurrentControlSet\Services\nm\Parameters\CapturePath`
NMERR_OUT_OF_MEMORY	La mémoire nécessaire pour effectuer cette opération n’est pas disponible. Cette erreur est générée par l’appel IESP::Configure .
NMERR_TIMEOUT	La demande a expiré. Cette erreur est générée par l’appel IESP::Configure .
NMERR_UPLEVEL_BLOB	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 IESP::Configure .

Notes

Lorsque la méthode Connect est appelée, le Moniteur réseau appelle automatiquement IESP::Configure à l’aide de l’objet BLOB fourni par le paramètre hInputBlob . Notez que tous les codes d’erreur retournés par l’appel à IESP::Configure sont renvoyés et retournés par l’appel IESP::Connect .

Cette méthode doit être appelée avant que vous puissiez commencer à capturer des images. Notez que lorsque vous vous connectez au réseau à l’aide de cette méthode, vous devez continuer à utiliser l’interface IESP pour capturer des trames.

L’objet BLOB d’entrée spécifié par hInputBlob peut être obtenu en appelant GetNPPBlobFromUI, GetNPPBlobTable et SelectNPPBlobFromTable.

L’objet BLOB d’erreur retourné par hErrorBlob contient des entrées que le 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’erreur retourné contient des informations d’erreur que l’application peut utiliser pour la résolution des problèmes. Par exemple, si NMERR_BLOB_ENTRY_DOES_NOT_EXIST est retourné, l’entrée que le 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 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

IESP
IESP::Configure
IESP::D isconnect
IESP::Start

Partager via