Lire en anglais

Partager via


Gestion des interfaces à l’aide de GetInterfaceInfo

La fonction GetInterfaceInfo remplit un pointeur vers une structure de IP_INTERFACE_INFO avec des informations sur les interfaces associées au système.

Pour utiliser GetInterfaceInfo

  1. Déclarez un pointeur vers un objet IP_INTERFACE_INFO appelé pInfoet un objet ULONG appelé ulOutBufLen. Déclarez également un objet DWORD appelé dwRetVal (utilisé pour la vérification des erreurs).

        ULONG               ulOutBufLen;
        DWORD               dwRetVal;
        unsigned int       i;
    
        IP_INTERFACE_INFO*  pInterfaceInfo;
    
  2. Allouez de la mémoire pour les structures.

    Notes

    La taille de n’est ulOutBufLen pas suffisante pour contenir les informations. Consultez l’étape suivante.

     

        pInterfaceInfo = (IP_INTERFACE_INFO *) malloc(sizeof (IP_INTERFACE_INFO));
        ulOutBufLen = sizeof(IP_INTERFACE_INFO);
    
    
  3. Effectuez un appel initial à GetInterfaceInfo pour obtenir la taille nécessaire dans la ulOutBufLen variable.

    Notes

    Cet appel à la fonction est destiné à échouer et permet de s’assurer que la ulOutBufLen variable spécifie une taille suffisante pour contenir toutes les informations retournées à pInfo. Il s’agit d’un modèle de programmation courant dans IP Helper pour les structures de données et les fonctions de ce type.

     

        if (GetInterfaceInfo(pInterfaceInfo, &ulOutBufLen) ==
            ERROR_INSUFFICIENT_BUFFER) {
            free(pInterfaceInfo);
            pInterfaceInfo = (IP_INTERFACE_INFO *) malloc(ulOutBufLen);
        }
    
  4. Effectuez un deuxième appel à GetInterfaceInfo avec une vérification générale des erreurs et retournez sa valeur à la variable dwRetValDWORD (pour une vérification des erreurs plus avancée).

        if ((dwRetVal = GetInterfaceInfo(pInterfaceInfo, &ulOutBufLen)) != NO_ERROR) {
            printf("  GetInterfaceInfo failed with error: %d\n", dwRetVal);
        }
    
  5. Si l’appel a réussi, accédez aux données à partir de la pInfo structure de données.

            printf("  GetInterfaceInfo succeeded.\n");
    
            printf("  Num Adapters: %ld\n\n", pInterfaceInfo->NumAdapters);
            for (i = 0; i < (unsigned int) pInterfaceInfo->NumAdapters; i++) {
                printf("  Adapter Index[%d]: %ld\n", i,
                       pInterfaceInfo->Adapter[i].Index);
                printf("  Adapter Name[%d]:  %ws\n\n", i,
                       pInterfaceInfo->Adapter[i].Name);
            }
        }
    

    Notes

    %ws de la première ligne indique une chaîne large. Cela est utilisé, car l’attribut Name de la structure AdapterIP_ADAPTER_INDEX_MAP est une chaîne WCHAR, qui est une chaîne Unicode.

     

  6. Libérez toute la mémoire allouée à la structure pInfo .

        if (pInterfaceInfo) {
            free(pInterfaceInfo);
            pInterfaceInfo = NULL;
        }
    

Étape suivante : Gestion des adresses IP à l’aide de GetIpAddrTable

Étape précédente : Gestion des cartes réseau à l’aide de GetAdaptersInfo