Membuat Fungsi Panggilan Balik Status

Tutorial ini menjelaskan cara membuat fungsi panggilan balik status yang digunakan untuk memantau status permintaan Internet.

Fungsi panggilan balik status menerima panggilan balik status pada permintaan Internet apa pun yang berasal dari fungsi WinINet mana pun yang diberikan nilai konteks bukan nol.

Langkah-langkah berikut diperlukan untuk membuat fungsi panggilan balik status:

Tentukan nilai konteks.
Membuat fungsi panggilan balik status.

Menentukan Nilai Konteks

Nilai konteks dapat berupa nilai bilangan bulat panjang yang tidak ditandatangani. Idealnya, nilai konteks harus mengidentifikasi permintaan apa yang baru saja diselesaikan dan lokasi sumber daya terkait, jika diperlukan.

Salah satu cara paling berguna untuk menggunakan nilai konteks adalah meneruskan alamat struktur dan mengubahnya ke DWORD_PTR. Struktur dapat digunakan untuk menyimpan informasi tentang permintaan, sehingga diteruskan ke fungsi panggilan balik status.

Struktur berikut adalah contoh kemungkinan nilai konteks. Para anggota struktur dipilih dengan mempertimbangkan fungsi InternetOpenUrl .

typedef struct{
    HWND       hWindow;      // Window handle
    int        nStatusList;  // List box control to hold callbacks
    HINTERNET  hResource;    // HINTERNET handle created by InternetOpenUrl
    char       szMemo[512];  // String to store status memo
} REQUEST_CONTEXT;

Dalam contoh ini, fungsi panggilan balik status akan memiliki akses ke handel jendela, yang akan memungkinkannya menampilkan antarmuka pengguna. Handle HINTERNET yang dibuat oleh InternetOpenUrl dapat diteruskan ke fungsi lain yang mampu mengunduh sumber daya dan array karakter yang dapat digunakan untuk memfasilitasi pengiriman informasi tentang permintaan.

Anggota struktur dapat diubah agar sesuai dengan kebutuhan aplikasi tertentu, jadi jangan merasa dibatasi oleh contoh ini.

Membuat Fungsi Panggilan Balik Status

Fungsi panggilan balik status harus mengikuti format InternetStatusCallback. Untuk melakukan ini:

Tulis deklarasi fungsi untuk fungsi panggilan balik status Anda.

Contoh berikut menunjukkan deklarasi sampel.

void CALLBACK CallMaster( HINTERNET,
                          DWORD_PTR,
                          DWORD,
                          LPVOID,
                          DWORD );

Tentukan fungsi apa yang akan dilakukan oleh panggilan balik status Anda. Untuk aplikasi yang melakukan panggilan asinkron, fungsi panggilan balik status harus menangani nilai INTERNET_STATUS_REQUEST_COMPLETE, yang menunjukkan permintaan asinkron selesai. Fungsi panggilan balik status juga dapat digunakan untuk melacak kemajuan permintaan Internet.

Secara umum, sebaiknya gunakan pernyataan pengalihan dengan dwInternetStatus sebagai nilai switch dan nilai status untuk pernyataan kasus. Bergantung pada jenis fungsi yang dipanggil aplikasi Anda, Anda dapat mengabaikan beberapa nilai status. Untuk definisi nilai status yang berbeda, lihat daftar di bawah parameter dwInternetStatus InternetStatusCallback.

Pernyataan pengalihan berikut adalah contoh cara menangani panggilan balik status.
```
switch (dwInternetStatus)
{
    case INTERNET_STATUS_REQUEST_COMPLETE:
        // Add code
        break;
    default:
        // Add code
        break;
}
```

Buat kode untuk menangani nilai status.

Kode untuk menangani masing-masing nilai status sangat bergantung pada penggunaan fungsi panggilan balik status yang Anda maksudkan. Untuk aplikasi yang hanya melacak kemajuan permintaan, menulis string ke kotak daftar mungkin semua yang Anda butuhkan. Untuk operasi asinkron, kode harus menangani beberapa data yang dikembalikan dalam panggilan balik.

Fungsi panggilan balik status berikut menggunakan fungsi pengalihan untuk menentukan nilai status dan membuat string yang menyertakan nama nilai status dan fungsi sebelumnya yang disebut, yang disimpan dalam anggota szMemo dari struktur REQUEST_CONTEXT.

void __stdcall CallMaster(
    HINTERNET hInternet,
    DWORD_PTR dwContext,
    DWORD dwInternetStatus,
    LPVOID lpvStatusInformation,
    DWORD dwStatusInformationLength
)
{
    UNREFERENCED_PARAMETER(hInternet);
    UNREFERENCED_PARAMETER(lpvStatusInformation);
    UNREFERENCED_PARAMETER(dwStatusInformationLength);

    REQUEST_CONTEXT *cpContext;
    cpContext = (REQUEST_CONTEXT*)dwContext;
    char szStatusText[80];

    switch (dwInternetStatus)
    {
        case INTERNET_STATUS_CLOSING_CONNECTION:
            StringCchPrintfA( szStatusText,
                              80,
                              "%s CLOSING_CONNECTION",
                              cpContext->szMemo);
            break;
        case INTERNET_STATUS_CONNECTED_TO_SERVER:
            StringCchPrintfA( szStatusText,
                              80,
                              "%s CONNECTED_TO_SERVER",
                              cpContext->szMemo );
            break;
        case INTERNET_STATUS_CONNECTING_TO_SERVER:
            StringCchPrintfA( szStatusText,
                              80,
                              "%s CONNECTING_TO_SERVER",
                              cpContext->szMemo );
            break;
        case INTERNET_STATUS_CONNECTION_CLOSED:
            StringCchPrintfA( szStatusText,
                              80,
                              "%s CONNECTION_CLOSED",
                              cpContext->szMemo );
            break;
        case INTERNET_STATUS_HANDLE_CLOSING:
            StringCchPrintfA( szStatusText,
                              80,
                              "%s HANDLE_CLOSING",
                              cpContext->szMemo );
            break;
        case INTERNET_STATUS_HANDLE_CREATED:
            StringCchPrintfA( szStatusText,
                              80,
                              "%s HANDLE_CREATED",
                              cpContext->szMemo);
            break;
        case INTERNET_STATUS_INTERMEDIATE_RESPONSE:
            StringCchPrintfA( szStatusText,
                              80,
                              "%s INTERMEDIATE_RESPONSE",
                              cpContext->szMemo );
            break;
        case INTERNET_STATUS_NAME_RESOLVED:
            StringCchPrintfA( szStatusText,
                              80,
                              "%s NAME_RESOLVED",
                              cpContext->szMemo);
            break;
        case INTERNET_STATUS_RECEIVING_RESPONSE:
            StringCchPrintfA( szStatusText,
                              80,
                              "%s RECEIVING_RESPONSE",
                              cpContext->szMemo);
            break;
        case INTERNET_STATUS_RESPONSE_RECEIVED:
            StringCchPrintfA( szStatusText,
                              80,
                              "%s RESPONSE_RECEIVED",
                              cpContext->szMemo);
            break;
        case INTERNET_STATUS_REDIRECT:
            StringCchPrintfA( szStatusText,
                              80,
                              "%s REDIRECT",
                              cpContext->szMemo );
            break;
        case INTERNET_STATUS_REQUEST_COMPLETE:
            StringCchPrintfA( szStatusText,
                              80,
                              "%s REQUEST_COMPLETE",
                              cpContext->szMemo);
            break;
        case INTERNET_STATUS_REQUEST_SENT:
            StringCchPrintfA( szStatusText,
                              80,
                              "%s REQUEST_SENT",
                              cpContext->szMemo);
            break;
        case INTERNET_STATUS_RESOLVING_NAME:
            StringCchPrintfA( szStatusText,
                              80,
                              "%s RESOLVING_NAME",
                              cpContext->szMemo );
            break;
        case INTERNET_STATUS_SENDING_REQUEST:
            StringCchPrintfA( szStatusText,
                              80,
                              "%s SENDING_REQUEST",
                              cpContext->szMemo );
            break;
        case INTERNET_STATUS_STATE_CHANGE:
            StringCchPrintfA( szStatusText,
                              80,
                              "%s STATE_CHANGE",
                              cpContext->szMemo );
            break;
        default:
            StringCchPrintfA( szStatusText,
                              80,
                              "%s Unknown Status %d Given",
                              cpContext->szMemo,
                              dwInternetStatus);
            break;
    }

    SendDlgItemMessage( cpContext->hWindow,
                      cpContext->nStatusList,
                      LB_ADDSTRING,
                      0, (LPARAM)szStatusText );

}

Gunakan fungsi InternetSetStatusCallback untuk mengatur fungsi panggilan balik status pada handle HINTERNET yang ingin Anda terima pembaruan statusnya.

Contoh berikut menunjukkan cara mengatur fungsi panggilan balik status.

HINTERNET hOpen;                       // Root HINTERNET handle
INTERNET_STATUS_CALLBACK iscCallback;  // Holds the callback function

// Create the root HINTERNET handle.
hOpen = InternetOpen( TEXT("Test Application"),
                      INTERNET_OPEN_TYPE_PRECONFIG,
                      NULL, NULL, 0);

// Set the status callback function.
iscCallback = InternetSetStatusCallback( hOpen, (INTERNET_STATUS_CALLBACK)CallMaster );

Nota

WinINet tidak mendukung implementasi server. Selain itu, tidak boleh digunakan dari layanan. Untuk implementasi atau layanan server, gunakan Microsoft Windows HTTP Services (WinHTTP).

Membuat Fungsi Status Callback
InternetSetStatusCallback
InternetStatusCallback

Saran dan Komentar

Apakah halaman ini membantu?

Last updated on 2025-03-21

Bagikan melalui

Membuat Fungsi Panggilan Balik Status

Menentukan Nilai Konteks

Membuat Fungsi Panggilan Balik Status

Topik terkait

Saran dan Komentar

Sumber Daya Tambahan: