IMcastAddressAllocation::CreateLeaseInfo-Methode (mdhcp.h)

[Steuerelemente und Schnittstellen für Rendezvous-IP-Telefonkonferenzen sind in Windows Vista, Windows Server 2008 und nachfolgenden Versionen des Betriebssystems nicht verfügbar. Die RTC-Client-API bietet ähnliche Funktionen.]

Die CreateLeaseInfo-Methode erstellt ein Leaseinformationsobjekt für einen nachfolgenden Aufruf von RenewAddress oder ReleaseAddress.

Syntax

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

Parameter

[in] LeaseStartTime

Die Startzeit der Lease.

[in] LeaseStopTime

Die Beendigungszeit der Lease.

[in] dwNumAddresses

Die Anzahl der Adressen, die der Lease zugeordnet sind.

[in] ppAddresses

Ein Array von LPWSTR-Zeigern der Größe dwNumAddresses. Jede LPWSTR ist eine IP-Adresse der Version 4 in gepunkteter Quad-Notation (z. B. 10.111.222.111).

[in] pRequestID

Ein LPWSTR , der die Anforderungs-ID für die ursprüngliche Anforderung angibt. Dies wird durch Aufrufen von IMcastLeaseInfo::get_RequestID für das Leaseinformationsobjekt abgerufen, das der ursprünglichen Anforderung entspricht. Die Anforderungs-ID sollte zwischen den Ausführungen des Anwendungsprogramms im persistenten Speicher gespeichert werden. Wenn Sie eine Lease verlängern oder freigeben, die während der gleichen Ausführung der Anwendung angefordert wurde, haben Sie keinen Grund, CreateLeaseInfo zu verwenden. übergeben Sie einfach den vorhandenen IMcastLeaseInfo-Zeiger auf RenewAddress oder ReleaseAddress.

[in] pServerAddress

Gibt die Serveradresse an.

[out] ppReleaseRequest

Zeiger auf die erstellte IMcastLeaseInfo-Schnittstelle .

Rückgabewert

Diese Methode kann einen dieser Werte zurückgeben.

Hinweise

TAPI ruft die AddRef-Methode auf der IMcastLeaseInfo-Schnittstelle auf, die von IMcastAddressAllocation::CreateLeaseInfo zurückgegeben wird. Die Anwendung muss Release auf der IMcastLeaseInfo-Schnittstelle aufrufen, um zugeordnete Ressourcen freizugeben.

Diese Funktion kann Daten unverschlüsselt über das Kabel senden; Daher kann jemand, der im Netzwerk lauscht, die Daten lesen. Das Sicherheitsrisiko beim Senden der Daten im Klartext sollte vor der Verwendung dieser Methode berücksichtigt werden.

Requirements (Anforderungen)

Weitere Informationen

IMcastAddressAllocation