Méthode INetworkCostManager ::GetDataPlanStatus (netlistmgr.h)
GetDataPlanStatus récupère le plan de données status pour une connexion Internet à l’échelle de l’ordinateur ou le premier tronçon de routage vers une destination spécifique sur une connexion. Si aucune adresse IPv4/IPv6 n’est spécifiée, cette méthode retourne le plan de données status de la connexion utilisée pour la connectivité Internet à l’échelle de l’ordinateur.
Syntaxe
HRESULT GetDataPlanStatus(
[out] NLM_DATAPLAN_STATUS *pDataPlanStatus,
[in] NLM_SOCKADDR *pDestIPAddr
);
Paramètres
[out] pDataPlanStatus
Pointeur vers une structure de NLM_DATAPLAN_STATUS qui décrit le plan de données status associé à une connexion utilisée pour acheminer vers une destination. Si destIPAddr spécifie une adresse de tunnel, le premier plan de données disponible status dans la pile d’interface est retourné.
[in] pDestIPAddr
Structure NLM_SOCKADDR contenant l’adresse IPv4/IPv6 ou tunnel de destination. Si la valeur est NULL, cette méthode retourne le coût associé à la connexion préférée utilisée pour la connectivité Internet de l’ordinateur.
Valeur retournée
Retourne S_OK en cas de réussite, sinon un code d’erreur HRESULT est retourné.
| Code de retour | Description |
|---|---|
|
pDataPlanStatus a la valeur NULL. |
|
Détermination de l’interface utilisée pour acheminer vers la destination |
|
L’adresse de destination spécifiée par destIPAddr n’est pas valide. |
|
La demande n'est pas prise en charge. Cette erreur est retournée si une pile IPv4 ou IPv6 n’est pas présente sur l’ordinateur local, mais qu’une adresse IPv4 ou IPv6 a été spécifiée par destIPAddr. |
|
La connectivité réseau n’est actuellement pas disponible. |
Configuration requise
| Condition requise | Valeur |
|---|---|
| Client minimal pris en charge | Windows 8 [applications de bureau uniquement] |
| Serveur minimal pris en charge | Aucun pris en charge |
| Plateforme cible | Windows |
| En-tête | netlistmgr.h |