IMcastLeaseInfo::get_ServerAddress-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 get_ServerAddress-Methode ruft eine Zeichenfolge ab, die die Adresse des Multicastservers darstellt, der diese Lease gewährt.

Syntax

HRESULT get_ServerAddress(
  [out] BSTR *ppAddress
);

Parameter

[out] ppAddress

Zeiger auf einen BSTR , der eine Zeichenfolgendarstellung der Adresse des Servers erhält, der diese Anforderung oder Verlängerung gewährt.

Rückgabewert

Diese Methode kann einen dieser Werte zurückgeben.

Rückgabecode BESCHREIBUNG
S_OK
Methode war erfolgreich.
S_FALSE
Serveradresse nicht angegeben.
E_POINTER
Der Aufrufer hat ein ungültiges Zeigerargument übergeben.
E_OUTOFMEMORY
Es ist nicht genügend Arbeitsspeicher vorhanden, um die Zeichenfolge zuzuordnen.

Hinweise

Die BSTR-ZeichenfolgeppAddress ist eine IP-Adresse der Version 4 in gepunkteter Quad-Notation (z. B. 10.111.222.111). Wenn ein Leaseinformationsobjekt keine gewährte Lease beschreibt (z. B. nicht von IMcastAddressAllocation::RequestAddress oder IMcastAddressAllocation::RenewAddress zurückgegeben), wird die Adresse als Zeichenfolge "Unspecified" gemeldet.

Die Anwendung muss SysFreeString verwenden, um den für den ppAddress-Parameter zugeordneten Arbeitsspeicher 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.

Anforderungen

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

Weitere Informationen

IMcastLeaseInfo