IMcastAddressAllocation::CreateLeaseInfoFromVariant-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 CreateLeaseInfoFromVariant-Methode erstellt ein Leaseinformationsobjekt für einen nachfolgenden Aufruf von RenewAddress oder ReleaseAddress. Diese Methode ähnelt CreateLeaseInfo , wird jedoch von Automation-Clientsprachen wie Visual Basic verwendet.
Syntax
HRESULT CreateLeaseInfoFromVariant(
[in] DATE LeaseStartTime,
[in] DATE LeaseStopTime,
[in] VARIANT vAddresses,
[in] BSTR pRequestID,
[in] BSTR pServerAddress,
[out] IMcastLeaseInfo **ppReleaseRequest
);
Parameter
[in] LeaseStartTime
Die Startzeit der Lease.
[in] LeaseStopTime
Die Beendigungszeit der Lease.
[in] vAddresses
Ein VARIANT-Wert , der ein SAFEARRAY von BSTR-Zeichenfolgen enthält. Jeder BSTR ist eine IP-Adresse der Version 4 in gepunkteter Quad-Notation (z. B. 10.111.222.111).
[in] pRequestID
Zeiger auf einen BSTR, 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
Zeiger auf einen BSTR, der die Serveradresse angibt.
[out] ppReleaseRequest
Zeiger auf die erstellte IMcastLeaseInfo-Schnittstelle .
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. |
Hinweise
Die Anwendung muss SysAllocString verwenden, um Arbeitsspeicher für die Parameter pRequestID und pServerAddress zuzuweisen. Die Anwendung muss SysFreeString verwenden, um den Arbeitsspeicher freizugeben, wenn die Variablen nicht mehr benötigt werden.
TAPI ruft die AddRef-Methode für die IMcastLeaseInfo-Schnittstelle auf, die von IMcastAddressAllocation::CreateLeaseInfoFromVariant 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)
| Zielplattform | Windows |
| Kopfzeile | mdhcp.h |
| Bibliothek | Uuid.lib |
| DLL | Mdhcp.dll |