Metodo IMcastAddressAllocation::CreateLeaseInfoFromVariant (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 CreateLeaseInfoFromVariant crea un oggetto informazioni lease per una chiamata successiva a RenewAddress o ReleaseAddress. Questo metodo è simile a CreateLeaseInfo , ma viene usato dai linguaggi client di Automazione, ad esempio Visual Basic.

Sintassi

HRESULT CreateLeaseInfoFromVariant(
  [in]  DATE            LeaseStartTime,
  [in]  DATE            LeaseStopTime,
  [in]  VARIANT         vAddresses,
  [in]  BSTR            pRequestID,
  [in]  BSTR            pServerAddress,
  [out] IMcastLeaseInfo **ppReleaseRequest
);

Parametri

[in] LeaseStartTime

Ora di inizio del lease.

[in] LeaseStopTime

Ora di arresto del lease.

[in] vAddresses

VALORE VARIANT contenente un SAFEARRAY di stringhe BSTR. Ogni BSTR è un indirizzo IP versione 4 nella notazione quad tratteggiata (ad esempio, 10.111.222.111).

[in] pRequestID

Puntatore a un BSTR 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

Puntatore a un BSTR che 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

L'applicazione deve usare SysAllocString per allocare memoria per i parametri pRequestID e pServerAddress . L'applicazione deve usare SysFreeString per liberare la memoria quando le variabili non sono più necessarie.

TAPI chiama il metodo AddRef sull'interfaccia IMcastLeaseInfo restituita da IMcastAddressAllocation::CreateLeaseInfoFromVariant. 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

IMcastLeaseInfo

Condividi tramite