IMcastLeaseInfo::get_RequestID-Methode (mdhcp.h)
[Rendezvous IP-Telefonkonferenzsteuerelemente und -schnittstellen sind in Windows Vista, Windows Server 2008 und nachfolgenden Versionen des Betriebssystems nicht verfügbar. Die RTC-Client-API bietet ähnliche Funktionen.]
Die get_RequestID-Methode ruft die Anforderungs-ID für eine Lease ab. Der Hauptzweck dieser Methode besteht darin, Ihnen das Speichern der Anforderungs-ID nach dem Beenden Ihrer Anwendung zu ermöglichen, sodass Sie IMcastAddressAllocation::CreateLeaseInfo aufrufen können, um das Leaseinformationsobjekt während einer nachfolgenden Ausführung erneut zu erstellen. Dadurch können Sie eine Lease verlängern oder freigeben, nachdem die instance Ihres Programms, das ursprünglich die Lease angefordert hat, beendet wurde.
Syntax
HRESULT get_RequestID(
[out] BSTR *ppRequestID
);
Parameter
[out] ppRequestID
Zeiger auf einen BSTR , der die Anforderungs-ID für diese Lease empfängt. Die Anforderungs-ID identifiziert diese Leaseanforderung eindeutig für den Server.
Rückgabewert
Diese Methode kann einen dieser Werte zurückgeben.
| Rückgabecode | BESCHREIBUNG |
|---|---|
|
Methode war erfolgreich. |
|
Das Leaseinformationsobjekt enthält eine ungültige Anforderungs-ID. |
|
Der Aufrufer hat ein ungültiges Zeigerargument übergeben. |
|
Nicht genügend Arbeitsspeicher, um den BSTR zuzuordnen. |
Hinweise
Die Anwendung muss SysFreeString verwenden, um den für den ppRequestID-Parameter zugewiesenen Arbeitsspeicher freizugeben.
Diese Funktion kann Daten unverschlüsselt über die Leitung senden. Daher kann jemand, der im Netzwerk lauscht, die Daten lesen. Das Sicherheitsrisiko des Sendens der Daten im Klartext sollte vor der Verwendung dieser Methode berücksichtigt werden.
Requirements (Anforderungen)
| Zielplattform | Windows |
| Kopfzeile | mdhcp.h |
| Bibliothek | Uuid.lib |
| DLL | Mdhcp.dll |