---
title: "GetPlayerIp | open.mp"
description: "دریافت آدرس IP بازیکن مشخص شده و ذخیره آن در یک رشته."
canonical: https://omp.itsneufox.com/fa/docs/scripting/functions/GetPlayerIp
language: fa
---

# GetPlayerIp

## توضیحات

دریافت آدرس IP بازیکن مشخص شده و ذخیره آن در یک رشته.

| نام | توضیحات |
| --- | --- |
| playerid | ID بازیکن برای دریافت آدرس IP. |
| ip\[\] | رشته برای ذخیره آدرس IP بازیکن، به صورت reference پاس داده می‌شود. |
| len = sizeof (ip) | حداکثر طول آدرس IP (16 توصیه می‌شود). |

## مقادیر برگشتی

**\-1** اگه بازیکن مشخص شده وجود نداشته باشه.

آدرس IP بازیکن در آرایه مشخص شده ذخیره می‌شود.

## مثال‌ها

```c
public OnPlayerConnect(playerid)
{
    new ipAddress[16];
    GetPlayerIp(playerid, ipAddress, sizeof(ipAddress));
    if (!strcmp(ipAddress, "127.0.0.1"))
    {
        SendClientMessage(playerid, 0xFFFFFFFF, "Welcome to your server, master :)");
    }
    return 1;
}
```

## نکات

یادداشت

-   PAWN حساس به حروف کوچک و بزرگ است. GetPlayerIP کار نخواهد کرد.
-   **سرور SA-MP**: این تابع در [OnPlayerDisconnect](https://omp.itsneufox.com/fa/docs/scripting/callbacks/OnPlayerDisconnect) **کار نمی‌کند** چون بازیکن قبلاً قطع شده است. IP نامعتبری (255.255.255.255) برمی‌گرداند. IPهای بازیکنان را در [OnPlayerConnect](https://omp.itsneufox.com/fa/docs/scripting/callbacks/OnPlayerConnect) ذخیره کنید اگر نیاز است در [OnPlayerDisconnect](https://omp.itsneufox.com/fa/docs/scripting/callbacks/OnPlayerDisconnect) استفاده شوند.
-   **سرور open.mp**: این تابع در [OnPlayerDisconnect](https://omp.itsneufox.com/fa/docs/scripting/callbacks/OnPlayerDisconnect) **کار می‌کند**.

## توابع مرتبط

-   [NetStats\_GetIpPort](https://omp.itsneufox.com/fa/docs/scripting/functions/NetStats_GetIpPort): دریافت IP و پورت بازیکن.
-   [GetPlayerRawIp](https://omp.itsneufox.com/fa/docs/scripting/functions/GetPlayerRawIp): دریافت Raw IP بازیکن.
-   [GetPlayerName](https://omp.itsneufox.com/fa/docs/scripting/functions/GetPlayerName): دریافت نام بازیکن.
-   [GetPlayerPing](https://omp.itsneufox.com/fa/docs/scripting/functions/GetPlayerPing): دریافت پینگ بازیکن.
-   [GetPlayerVersion](https://omp.itsneufox.com/fa/docs/scripting/functions/GetPlayerVersion): دریافت نسخه کلاینت بازیکن.

## کالبک‌های مرتبط

-   [OnIncomingConnection](https://omp.itsneufox.com/fa/docs/scripting/callbacks/OnIncomingConnection): زمانی که بازیکن در حال تلاش برای اتصال به سرور است فراخوانی می‌شود.
-   [OnPlayerConnect](https://omp.itsneufox.com/fa/docs/scripting/callbacks/OnPlayerConnect): زمانی که بازیکن به سرور متصل می‌شود فراخوانی می‌شود.
-   [OnPlayerDisconnect](https://omp.itsneufox.com/fa/docs/scripting/callbacks/OnPlayerDisconnect): زمانی که بازیکن سرور را ترک می‌کند فراخوانی می‌شود.