inet_addr Makro (wsipv6ok.h)

Artikel
03/04/2024

Die inet_addr-Funktion konvertiert eine Zeichenfolge, die eine IPv4-Dezimaladresse enthält, in eine richtige Adresse für die IN_ADDR-Struktur .

Syntax

void inet_addr(
  [in]  a
);

Parameter

[in] a

Eine NULL-endende Zeichenfolge, die eine Zahl darstellt, die im Internetstandard ". (gepunktete) Notation.

Rückgabewert

Keine

Bemerkungen

Die funktion inet_addr interpretiert die durch den cp-Parameter angegebene Zeichenfolge. Diese Zeichenfolge stellt eine numerische Internetadresse dar, die im Internetstandard ". Notation. Der zurückgegebene Wert ist eine Zahl, die für die Verwendung als Internetadresse geeignet ist. Alle Internetadressen werden in der Ip-Netzwerkreihenfolge (byte von links nach rechts sortiert) zurückgegeben. Wenn Sie " " " ( ein Leerzeichen) an die inet_addr-Funktion übergeben, gibt inet_addr null zurück.

Unter Windows Vista und höher kann die RtlIpv4StringToAddress-Funktion verwendet werden, um eine Zeichenfolgendarstellung einer IPv4-Adresse in eine binäre IPv4-Adresse zu konvertieren, die als IN_ADDR-Struktur dargestellt wird. Unter Windows Vista und höher kann die RtlIpv6StringToAddress-Funktion verwendet werden, um eine Zeichenfolgendarstellung einer IPv6-Adresse in eine binäre IPv6-Adresse zu konvertieren, die als IN6_ADDR-Struktur dargestellt wird.

Internetadressen

Werte, die mithilfe von ".'" angegeben wurden Die Notation hat eine der folgenden Formen:

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

Wenn vier Teile angegeben werden, wird jeder als Byte von Daten interpretiert und den 4 Bytes einer Internetadresse von links nach rechts zugewiesen. Wenn eine Internetadresse in der Intel-Architektur als ganzzahlige 32-Bit-Menge angezeigt wird, werden die oben genannten Bytes als "d.c.b.a" angezeigt. Das heißt, die Bytes auf einem Intel-Prozessor werden von rechts nach links sortiert.

Die Teile, aus denen eine Adresse in der Notation "." besteht, können dezimal, oktal oder hexadezimal sein, wie in der Sprache C angegeben. Zahlen, die mit "0x" oder "0X" beginnen, implizieren hexadezimal. Zahlen, die mit "0" beginnen, implizieren oktal. Alle anderen Zahlen werden als Dezimalstellen interpretiert.

Internetadressenwert	Bedeutung
"4.3.2.16"	Decimal
"004.003.002.020"	Oktal
"0x4.0x3.0x2.0x10"	Hexadezimal
"4.003.002.0x10"	Mischung

Die inet_addr-Funktion unterstützt die dezimalen, oktalen, hexadezimalen und gemischten Notationen für die im cp-Parameter übergebene Zeichenfolge.

Hinweis Die folgenden Notationen werden nur von Berkeley-Software und nirgendwo sonst im Internet verwendet. Aus Gründen der Kompatibilität mit Berkeley-Software unterstützt die funktion inet_addr auch die unten angegebenen zusätzlichen Notationen.

Wenn eine dreiteilige Adresse angegeben wird, wird der letzte Teil als 16-Bit-Menge interpretiert und in die 2 Byte rechts der Netzwerkadresse eingefügt. Dadurch ist das dreiteilige Adressformat für die Angabe von Netzwerkadressen der Klasse B als "128.net.host" praktisch.

Wenn eine zweiteilige Adresse angegeben wird, wird der letzte Teil als 24-Bit-Menge interpretiert und in den 3 Byte rechts der Netzwerkadresse platziert. Dadurch ist das zweiteilige Adressformat für die Angabe von Netzwerkadressen der Klasse A als "net.host" praktisch.

Wenn nur ein Teil angegeben wird, wird der Wert ohne Byte-Neuanordnung direkt in der Netzwerkadresse gespeichert.

Windows Phone 8: Diese Funktion wird für Windows Phone Store-Apps ab Windows Phone 8 unterstützt.

Windows 8.1 und Windows Server 2012 R2: Diese Funktion wird für Windows Store-Apps auf Windows 8.1, Windows Server 2012 R2 und höher unterstützt.

Beispiele

Im folgenden Codebeispiel wird die Verwendung der inet_addr-Funktion veranschaulicht.

#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;
}

Anforderungen

Anforderung	Wert
Unterstützte Mindestversion (Client)	Windows 8.1, Windows Vista [Desktop-Apps \| UWP-Apps]
Unterstützte Mindestversion (Server)	Windows Server 2003 [Desktop-Apps \| UWP-Apps]
Zielplattform	Windows
Kopfzeile	wsipv6ok.h (einschließlich Winsock2.h, Winsock.h)
Bibliothek	Ws2_32.lib
DLL	Ws2_32.dll