Metode IMcastAddressAllocation::RequestAddress (mdhcp.h)

Artikel
08/24/2023

[Kontrol dan antarmuka Konferensi Telepon IP Pertemuan tidak tersedia untuk digunakan di Windows Vista, Windows Server 2008, dan versi sistem operasi berikutnya. API Klien RTC menyediakan fungsionalitas serupa.]

Metode RequestAddress mendapatkan sewa baru untuk satu atau beberapa alamat multicast. Metode EnumerateScopes atau get_Scopes harus dipanggil terlebih dahulu.

Sintaks

HRESULT RequestAddress(
  [in]  IMcastScope     *pScope,
  [in]  DATE            LeaseStartTime,
  [in]  DATE            LeaseStopTime,
  [in]  long            NumAddresses,
  [out] IMcastLeaseInfo **ppLeaseResponse
);

Parameter

[in] pScope

Mengidentifikasi cakupan multicast tempat aplikasi membutuhkan alamat. Aplikasi pertama kali memanggil get_Scopes atau EnumerateScopes untuk mendapatkan daftar cakupan yang tersedia.

[in] LeaseStartTime

Meminta waktu untuk sewa pada alamat ini untuk memulai. Waktu mulai yang benar-benar diberikan mungkin berbeda.

[in] LeaseStopTime

Meminta waktu agar sewa pada alamat ini berhenti. Waktu berhenti yang benar-benar diberikan mungkin berbeda.

[in] NumAddresses

Jumlah alamat yang diminta. Lebih sedikit alamat yang benar-benar dapat diberikan.

[out] ppLeaseResponse

Penunjuk ke penunjuk antarmuka yang akan diatur untuk menunjuk ke objek IMcastLeaseInfo baru. Antarmuka ini kemudian dapat digunakan untuk menemukan atribut aktual dari sewa yang diberikan. Lihat IMcastScope untuk informasi selengkapnya.

Menampilkan nilai

Metode ini dapat mengembalikan salah satu nilai ini.

Nilai	Makna
S_OK	Metode berhasil.
E_POINTER	Penelepon meneruskan argumen penunjuk yang tidak valid.
E_OUTOFMEMORY	Tidak ada cukup memori untuk membuat objek yang diperlukan.
E_INVALIDARG	Waktu berhenti yang diminta adalah sebelum waktu berhenti yang diminta.

Keterangan

Meskipun antarmuka COM ini dan implementasinya mendukung alokasi beberapa alamat sekaligus, beberapa alokasi saat ini tidak didukung oleh panggilan fungsi yang mendasar. Anda mungkin perlu menggunakan perulangan untuk beberapa alokasi alamat.

TAPI memanggil metode AddRef pada antarmuka IMcastLeaseInfo yang dikembalikan oleh IMcastAddressAllocation::RequestAddress. Aplikasi harus memanggil Rilis pada antarmuka IMcastLeaseInfo ke sumber daya gratis yang terkait dengannya.

Persyaratan


Target Platform	Windows
Header	mdhcp.h
Pustaka	Uuid.lib
DLL	Mdhcp.dll

Lihat juga

IMcastAddressAllocation