IRTC::QueryStatus, méthode
La méthode QueryStatus récupère les status du NPP.
Syntaxe
HRESULT STDMETHODCALLTYPE QueryStatus(
[out] NETWORKSTATUS *pNetworkStatus
);
Paramètres
-
pNetworkStatus [out]
-
Pointeur vers une structure NETWORKSTATUS retournée qui indique l’état actuel (capture, pause, arrêt, etc.) du NPP. Il incombe à l’application d’allouer et de libérer la mémoire pour la structure NETWORKSTATUS .
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 le code d’erreur suivant :
| Code de retour | Description |
|---|---|
|
Le paramètre pNetworkStatus ne pointe pas vers une structure NETWORKSTATUS valide. Allouez de la mémoire pour cette structure et appelez à nouveau IRTC::QueryStatus . |
Notes
Cette méthode peut être appelée à tout moment après l’appel de la méthode CreateNPPInterface . Vous pouvez appeler cette méthode pour voir si le NPP est connecté au réseau, pour déterminer la status de la capture actuelle et pour voir si des déclencheurs sont en attente. Toutefois, avant d’appeler cette méthode, vous devez allouer la mémoire nécessaire à la structure NETWORKSTATUS et libérer cette mémoire lorsque la structure n’est plus nécessaire.
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 |
|