Méthode IDelaydC::Connect

Article
06/13/2023

La méthode Connect connecte le NPP au réseau à l’aide d’une interface réseau spécifiée carte et fournit des informations de configuration sur 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 vous vous connectez et les informations de configuration relatives à cette connexion.
StatusCallbackProc [in]: Adresse de la fonction de rappel de l’utilisateur, qui est utilisée pour recevoir status mises à jour 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 transmise lors de l’appel de la fonction de rappel de l’utilisateur. 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 dans un objet BLOB d’erreur qui contient des informations d’erreur supplémentaires.

Valeur retournée

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 IDelaydC::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 IDelaydC::Configure .
NMERR_BLOB_ENTRY_DOES_NOT_EXIST	L’objet BLOB d’entrée spécifié par hInputBlob ne contient pas d’entrée nécessaire pour effectuer cette opération. Cette erreur peut être générée par l’appel IDelaydC::Connect ou IDelaydC::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 IDelaydC::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 IDelaydC::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 IDelaydC::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 IDelaydC::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	Aucune mémoire n’était disponible pour effectuer cette opération. Cette erreur est générée par l’appel IDelaydC::Configure .
NMERR_TIMEOUT	Le délai de la demande a expiré. Cette erreur est générée par l’appel IDelaydC::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 IDelaydC::Configure .

Notes

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

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

L’objet BLOB d’entrée spécifié par le paramètre hInputBlob peut être obtenu en appelant 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 résoudre les problèmes. 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. Par exemple, si NMERR_BLOB_ENTRY_DOES_NOT_EXIST est retourné, 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

IDelaydC
IDelaydC::Configure
IDelaydC::D isconnect
IDelaydC::Start