macro inet_addr (wsipv6ok.h)

Article
03/13/2024

La fonction inet_addr convertit une chaîne contenant une adresse décimale en pointillés IPv4 en adresse appropriée pour la structure IN_ADDR .

Syntaxe

void inet_addr(
  [in]  a
);

Paramètres

[in] a

Chaîne de caractères terminée par NULL représentant un nombre exprimé dans la norme Internet . '' notation (pointillée).

Valeur de retour

None

Remarques

La fonction inet_addr interprète la chaîne de caractères spécifiée par le paramètre cp . Cette chaîne représente une adresse Internet numérique exprimée dans la norme Internet « ». notation. La valeur retournée est un nombre qui peut être utilisé comme adresse Internet. Toutes les adresses Internet sont retournées dans l’ordre réseau de l’adresse IP (octets classés de gauche à droite). Si vous passez « » (un espace) à la fonction inet_addr , inet_addr retourne zéro.

Sur Windows Vista et versions ultérieures, la fonction RtlIpv4StringToAddress peut être utilisée pour convertir une représentation sous forme de chaîne d’une adresse IPv4 en adresse IPv4 binaire représentée sous forme de structure IN_ADDR . Sur Windows Vista et versions ultérieures, la fonction RtlIpv6StringToAddress peut être utilisée pour convertir une représentation sous forme de chaîne d’une adresse IPv6 en adresse IPv6 binaire représentée sous forme de structure IN6_ADDR .

Adresses Internet

Valeurs spécifiées à l’aide du « . '' la notation prend l’une des formes suivantes :

a.b.c.d a.b.c a.b a

Lorsque quatre parties sont spécifiées, chacune est interprétée comme un octet de données et affectée, de gauche à droite, aux 4 octets d’une adresse Internet. Lorsqu’une adresse Internet est affichée sous la forme d’une quantité entière 32 bits sur l’architecture Intel, les octets mentionnés ci-dessus apparaissent sous la forme « d.c.b.a ». Autrement dit, les octets d’un processeur Intel sont classés de droite à gauche.

Les parties qui composent une adresse dans la notation « ». peuvent être décimales, octales ou hexadécimales, comme spécifié dans le langage C. Les nombres qui commencent par « 0x » ou « 0X » impliquent une valeur hexadécimale. Les nombres commençant par « 0 » impliquent une octale. Tous les autres nombres sont interprétés comme décimaux.

Valeur de l’adresse Internet	Signification
"4.3.2.16"	Decimal
"004.003.002.020"	Octal
« 0x4.0x3.0x2.0x10 »	Valeur hexadécimale
« 4.003.002.0x10 »	Combinaison

La fonction inet_addr prend en charge les notations décimales, octales, hexadécimales et mixtes pour la chaîne transmise dans le paramètre cp .

Note Les notations suivantes ne sont utilisées que par le logiciel Berkeley, et nulle part ailleurs sur Internet. Pour la compatibilité avec le logiciel Berkeley, la fonction inet_addr prend également en charge les notations supplémentaires spécifiées ci-dessous.

Lorsqu’une adresse en trois parties est spécifiée, la dernière partie est interprétée comme une quantité 16 bits et placée dans les 2 octets les plus à droite de l’adresse réseau. Cela rend le format d’adresse en trois parties pratique pour spécifier les adresses réseau de classe B comme « 128.net.host »

Lorsqu’une adresse en deux parties est spécifiée, la dernière partie est interprétée comme une quantité 24 bits et placée dans les 3 octets les plus à droite de l’adresse réseau. Cela rend le format d’adresse en deux parties pratique pour spécifier les adresses réseau de classe A comme « net.host ».

Lorsqu’une seule partie est donnée, la valeur est stockée directement dans l’adresse réseau sans réarrangement d’octets.

Windows Phone 8 : cette fonction est prise en charge pour les applications du Store Windows Phone Windows Phone 8 et versions ultérieures.

Windows 8.1 et Windows Server 2012 R2 : cette fonction est prise en charge pour les applications du Windows Store sur Windows 8.1, Windows Server 2012 R2 et versions ultérieures.

Exemples

L’exemple de code suivant montre comment utiliser la fonction inet_addr .

#define WIN32_LEAN_AND_MEAN

#include <winsock2.h>
#include <stdio.h>
#include <windows.h>


// need link with Ws2_32.lib
#pragma comment(lib, "Ws2_32.lib")

int __cdecl main(int argc, char **argv)
{

    //-----------------------------------------
    // Declare and initialize variables
    WSADATA wsaData;
    int iResult;

    unsigned long ulAddr = INADDR_NONE;

    // Validate the parameters
    if (argc != 2) {
        printf("usage: %s <IPv4 address>\n", argv[0]);
        printf("  inetaddr converts a string containing an\n");
        printf("  IPv4 address in one of the supported formats\n");
        printf("  to a unsigned long representing an IN_ADDR\n");
        printf("      %s 192.168.16.34\n", argv[0]);
        return 1;
    }
    // Initialize Winsock
    iResult = WSAStartup(MAKEWORD(2, 2), &wsaData);
    if (iResult != 0) {
        printf("WSAStartup failed: %d\n", iResult);
        return 1;
    }

//--------------------------------
// Call inet_addr(). If the call succeeds,
// the result variable will hold a IN_ADDR
    ulAddr = inet_addr(argv[1]);
    if ( ulAddr == INADDR_NONE ) {
        printf("inet_addr failed and returned INADDR_NONE\n");
        WSACleanup();
        return 1;
    }   
    
    if (ulAddr == INADDR_ANY) {
        printf("inet_addr failed and returned INADDR_ANY\n");
        WSACleanup();
        return 1;  
    }

    printf("inet_addr returned success\n");
    
    // Here we could implement code to retrieve each address and 
    // print out the hex bytes
    // for(i=0, ptr= (Char*) &ulAddr; i < 4; i++, ptr++) {

    WSACleanup();
    return 0;
}

Configuration requise

Condition requise	Valeur
Client minimal pris en charge	Windows 8.1, Windows Vista [applications de bureau \| Applications UWP]
Serveur minimal pris en charge	Windows Server 2003 [applications de bureau \| applications UWP]
Plateforme cible	Windows
En-tête	wsipv6ok.h (inclure Winsock2.h, Winsock.h)
Bibliothèque	Ws2_32.lib
DLL	Ws2_32.dll