IMcastAddressAllocation::RequestAddress-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 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 |
|---|---|
|
Methode war erfolgreich. |
|
Der Aufrufer hat ein ungültiges Zeigerargument übergeben. |
|
Es ist nicht genügend Arbeitsspeicher vorhanden, um die erforderlichen Objekte zu erstellen. |
|
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 |