C/C++ 獲取本機 IP 位址完整範例

在網路程式設計中，獲取本機 IP 位址是基礎需求。本文提供一個基於 Winsock 2.0 的完整主控台程式範例，展示如何透過 gethostname() 取得主機名稱，再以 gethostbyname() 解析對應的所有 IP 位址（支援多網卡環境）。

完整原始碼

/* 編譯環境: Visual C++ */
#include 
#include 
#pragma comment(lib, "ws2_32.lib")

int doit(int argc, char **argv)
{
    char host_name[255];
    // 取得本地主機名稱
    if (gethostname(host_name, sizeof(host_name)) == SOCKET_ERROR) {
        printf("Error %d when getting local host name.\n", WSAGetLastError());
        return 1;
    }
    printf("Host name is: %s\n", host_name);

    // 從主機資料庫取得 hostent 結構
    struct hostent *phe = gethostbyname(host_name);
    if (phe == 0) {
        printf("Yow! Bad host lookup.\n");
        return 1;
    }

    // 列舉所有 IP 位址
    for (int i = 0; phe->h_addr_list[i] != 0; ++i) {
        struct in_addr addr;
        memcpy(&addr, phe->h_addr_list[i], sizeof(struct in_addr));
        printf("Address %d : %s\n", i, inet_ntoa(addr));
    }
    return 0;
}

int main(int argc, char *argv[])
{
    WSADATA wsaData;
    // 初始化 Winsock 1.1
    if (WSAStartup(MAKEWORD(1, 1), &wsaData) != 0) {
        return 255;
    }
    int retval = doit(argc, argv);
    WSACleanup();
    return retval;
}

關鍵步驟解析

1. WSAStartup()：初始化 Winsock DLL，指定版本 1.1
2. gethostname()：取得本機主機名稱（如 "DESKTOP-ABC123"）
3. gethostbyname()：依主機名稱查詢 hostent 結構，包含 IP 位址列表（h_addr_list）
4. 迴圈處理 h_addr_list：逐一轉換為 in_addr 結構，再以 inet_ntoa() 轉為點分十進制字串
5. WSACleanup()：釋放 Winsock 資源

注意事項

• gethostbyname() 已被標記為過時，現代程式建議使用 getaddrinfo() 支援 IPv6
• 多網卡環境下會列出所有綁定的 IPv4 位址（含 127.0.0.1）
• 需連結 ws2_32.lib，或以 #pragma comment(lib, "ws2_32.lib") 自動連結

進階擴充

若需支援 IPv6 或取得網卡介面資訊（如介面名稱、MAC 位址、子網路遮罩），可改用 GetAdaptersAddresses() (IP Helper API) 或 getaddrinfo() 搭配 AI_ALL 旗標。