Metodo IMcastAddressAllocation::CreateLeaseInfo (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 CreateLeaseInfo crea un oggetto informazioni lease per una chiamata successiva a RenewAddress o ReleaseAddress.

Sintassi

HRESULT CreateLeaseInfo(
  [in]  DATE            LeaseStartTime,
  [in]  DATE            LeaseStopTime,
  [in]  DWORD           dwNumAddresses,
  [in]  LPWSTR          *ppAddresses,
  [in]  LPWSTR          pRequestID,
  [in]  LPWSTR          pServerAddress,
  [out] IMcastLeaseInfo **ppReleaseRequest
);

Parametri

[in] LeaseStartTime

Ora di inizio del lease.

[in] LeaseStopTime

Ora di arresto del lease.

[in] dwNumAddresses

Numero di indirizzi associati al lease.

[in] ppAddresses

Matrice di puntatori LPWSTR di dimensioni dwNumAddresses. Ogni LPWSTR è un indirizzo IP versione 4 nella notazione quad tratteggiata ,ad esempio 10.111.222.111.

[in] pRequestID

Un LPWSTR che specifica l'ID richiesta per la richiesta originale. Questa operazione viene ottenuta chiamando IMcastLeaseInfo::get_RequestID sull'oggetto informazioni sul lease corrispondente alla richiesta originale. L'ID richiesta deve essere salvato nell'archiviazione permanente tra le esecuzioni del programma dell'applicazione. Se si rinnova o rilascia un lease richiesto durante la stessa esecuzione dell'applicazione, non è necessario usare CreateLeaseInfo; è sufficiente passare il puntatore IMcastLeaseInfo esistente a RenewAddress o ReleaseAddress.

[in] pServerAddress

Specifica l'indirizzo del server.

[out] ppReleaseRequest

Puntatore all'interfaccia IMcastLeaseInfo creata.

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.

Commenti

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

Questa funzione può inviare dati in transito in formato non crittografato; pertanto, un utente che esegue l'intercettazione sulla rete potrebbe essere in grado di leggere i dati. Il rischio di sicurezza di inviare i dati in testo non crittografato deve essere considerato prima di usare questo metodo.

Requisiti


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

Vedi anche

IMcastAddressAllocation

Condividi tramite