Méthode INetConnection ::GetProperties (netcon.h)
[Le pare-feu de connexion Internet peut être modifié ou indisponible dans les versions ultérieures. Utilisez plutôt l’API pare-feu Windows.]
La méthode GetProperties récupère une structure qui contient les propriétés de cette connexion réseau.
Syntaxe
HRESULT GetProperties(
[out] NETCON_PROPERTIES **ppProps
);
Paramètres
[out] ppProps
Pointeur vers un pointeur qui, en cas de retour réussi, pointe vers une structure NETCON_PROPERTIES qui contient les propriétés de cette connexion réseau.
Valeur retournée
Si la méthode réussit, la valeur de retour est S_OK.
Si la méthode échoue, la valeur de retour est l’un des codes d’erreur suivants.
| Code de retour | Description |
|---|---|
|
L'opération a été abandonnée. |
|
Une erreur non spécifiée s'est produite. |
|
L’un des paramètres n’est pas valide. |
|
Une interface spécifiée n’est pas prise en charge. |
|
Une méthode spécifiée n’est pas implémentée. |
|
La méthode n’a pas pu allouer la mémoire requise. |
|
Un pointeur passé en tant que paramètre n’est pas valide. |
|
La méthode a échoué pour des raisons inconnues. |
Remarques
L’application appelante doit libérer la mémoire occupée par la structure NETCON_PROPERTIES retournée par GetProperties. Libérez la mémoire en appelant la fonction NcFreeNetconProperties . Cette fonction est définie dans NetCon.h et est exportée par NetShell.dll.
Configuration requise
| Condition requise | Valeur |
|---|---|
| Client minimal pris en charge | Windows XP [applications de bureau uniquement] |
| Serveur minimal pris en charge | Aucun pris en charge |
| Plateforme cible | Windows |
| En-tête | netcon.h |
| DLL | Hnetcfg.dll |
Voir aussi
Partage de connexion Internet et interfaces de pare-feu de connexion Internet
Informations de référence sur le partage de connexion Internet et le pare-feu de connexion Internet