Metodo IMcastAddressAllocation::RequestAddress (mdhcp.h)

Articolo
08/24/2023

[I controlli e le interfacce di telefonia IP rendezvous IP non sono disponibili per l'uso in Windows Vista, Windows Server 2008 e versioni successive del sistema operativo. L'API client RTC offre funzionalità simili.

Il metodo RequestAddress ottiene un nuovo lease per uno o più indirizzi multicast. Il metodo EnumerateScopes o get_Scopes deve essere chiamato per primo.

Sintassi

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

Parametri

[in] pScope

Identifica l'ambito multicast da cui l'applicazione necessita di un indirizzo. L'applicazione chiama prima get_Scopes o EnumerateScopes per ottenere un elenco di ambiti disponibili.

[in] LeaseStartTime

Tempo richiesto per l'avvio del lease su questi indirizzi. L'ora di inizio effettivamente concessa può essere diversa.

[in] LeaseStopTime

Tempo richiesto per l'arresto del lease su questi indirizzi. L'ora di arresto effettivamente concessa può essere diversa.

[in] NumAddresses

Numero di indirizzi richiesti. È possibile concedere un minor numero di indirizzi.

[out] ppLeaseResponse

Puntatore a un puntatore di interfaccia che verrà impostato in modo che punti a un nuovo oggetto IMcastLeaseInfo . Questa interfaccia può quindi essere usata per individuare gli attributi effettivi del lease concesso. Per altre informazioni , vedere IMcastScope .

Valore restituito

Questo metodo può restituire uno di questi valori.

Valore	Significato
S_OK	Il metodo è riuscito.
E_POINTER	Il chiamante passato in un argomento puntatore non valido.
E_OUTOFMEMORY	Memoria insufficiente per creare gli oggetti necessari.
E_INVALIDARG	L'ora di arresto richiesta è precedente all'ora di arresto richiesta.

Commenti

Anche se queste interfacce COM e la relativa implementazione supportano l'allocazione di più indirizzi alla volta, l'allocazione multipla non è attualmente supportata dalle chiamate di funzione sottostanti. Potrebbe essere necessario usare un ciclo per l'allocazione di più indirizzi.

TAPI chiama il metodo AddRef sull'interfaccia IMcastLeaseInfo restituita da IMcastAddressAllocation::RequestAddress. L'applicazione deve chiamare Release sull'interfaccia IMcastLeaseInfo per liberare le risorse associate.

Requisiti


Piattaforma di destinazione	Windows
Intestazione	mdhcp.h
Libreria	Uuid.lib
DLL	Mdhcp.dll

Vedi anche

IMcastAddressAllocation

Condividi tramite