IStats::Connect, méthode

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 pour la connexion.

Syntaxe

HRESULT STDMETHODCALLTYPE Connect(
  [in]  HBLOB  hInputBlob,
  [in]  LPVOID StatusCallbackProc,
  [in]  LPVOID 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 IStats::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 IStats::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 IStats::Connect ou IStats::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 IStats::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 IStats::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 IStats::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 IStats::Configure .
NMERR_NO_DEFAULT_CAPTURE_DIRECTORY	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. `HKEY_LOCAL_MACHINE\System\CurrentControlSet\Services\nm\Parameters\CapturePath`
NMERR_OUT_OF_MEMORY	La mémoire nécessaire pour effectuer cette opération n’était pas disponible. Cette erreur est générée par l’appel IStats::Configure .
NMERR_TIMEOUT	La demande a expiré. Cette erreur est générée par l’appel IStats::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 IStats::Configure .

Notes

Lorsque la méthode Connect est appelée, network Monitor appelle automatiquement la méthode IStats::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 à IStats::Configure sont renvoyés et retournés par l’appel IStats::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 IStats pour capturer des trames.

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 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 interface réseau carte	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

IStats
IStats::Configure
IStats::D isconnect
OBJETS BLOB du moniteur réseau

Partager via