IMcastAddressAllocation::RequestAddress-Methode (mdhcp.h)

  • Artikel

[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 RequestAddress-Methode ruft eine neue Lease für eine oder mehrere Multicastadressen ab. Die EnumerateScopes - oder get_Scopes-Methode muss zuerst aufgerufen werden.

Syntax

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

Parameter

[in] pScope

Gibt den Multicastbereich an, von dem die Anwendung eine Adresse benötigt. Die Anwendung ruft zuerst get_Scopes oder EnumerateScopes auf, um eine Liste der verfügbaren Bereiche abzurufen.

[in] LeaseStartTime

Angeforderte Zeit für den Start der Lease für diese Adressen. Die tatsächlich gewährte Startzeit kann unterschiedlich sein.

[in] LeaseStopTime

Angeforderte Zeit für das Beenden der Lease für diese Adressen. Die tatsächlich gewährte Stoppzeit kann unterschiedlich sein.

[in] NumAddresses

Die Anzahl der angeforderten Adressen. Es können tatsächlich weniger Adressen gewährt werden.

[out] ppLeaseResponse

Zeiger auf einen Schnittstellenzeiger, der auf ein neues IMcastLeaseInfo-Objekt verweist. Diese Schnittstelle kann dann verwendet werden, um die tatsächlichen Attribute der gewährten Lease zu ermitteln. Weitere Informationen finden Sie unter IMcastScope .

Rückgabewert

Diese Methode kann einen dieser Werte zurückgeben.

Wert Bedeutung
S_OK
 Methode war erfolgreich.
E_POINTER
 Der Aufrufer hat ein ungültiges Zeigerargument übergeben.
E_OUTOFMEMORY
 Es ist nicht genügend Arbeitsspeicher vorhanden, um die erforderlichen Objekte zu erstellen.
E_INVALIDARG
 Die angeforderte Stoppzeit liegt vor der angeforderten Beendigungszeit.

Hinweise

Obwohl diese COM-Schnittstellen und ihre Implementierung die Zuordnung mehrerer Adressen gleichzeitig unterstützen, wird die mehrfache Zuordnung derzeit nicht von den zugrunde liegenden Funktionsaufrufen unterstützt. Möglicherweise müssen Sie eine Schleife für die Zuordnung mehrerer Adressen verwenden.

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

Requirements (Anforderungen)

   
Zielplattform Windows
Kopfzeile mdhcp.h
Bibliothek Uuid.lib
DLL Mdhcp.dll

Weitere Informationen

IMcastAddressAllocation