Metodo IMcastLeaseInfo::get_RequestID (mdhcp.h)
[I controlli e le interfacce di telefonia IP rendezvous IP non sono disponibili per l'uso in Windows Vista, Windows Server 2008 e versioni successive del sistema operativo. L'API client RTC offre funzionalità simili.
Il metodo get_RequestID ottiene l'ID richiesta per un lease. Lo scopo principale di questo metodo è quello di consentire di salvare l'ID richiesta dopo l'uscita dell'applicazione, in modo da poter chiamare IMcastAddressAllocation::CreateLeaseInfo per ricreare l'oggetto informazioni sul lease durante un'esecuzione successiva. In questo modo è possibile rinnovare o rilasciare un lease dopo l'istanza del programma che ha originariamente richiesto il lease è uscito.
Sintassi
HRESULT get_RequestID(
[out] BSTR *ppRequestID
);
Parametri
[out] ppRequestID
Puntatore a un BSTR che riceverà l'ID richiesta per questo lease. L'ID richiesta identifica in modo univoco la richiesta di lease al server.
Valore restituito
Questo metodo può restituire uno di questi valori.
| Codice restituito | Descrizione |
|---|---|
|
Il metodo è riuscito. |
|
L'oggetto informazioni lease contiene un ID richiesta non valido. |
|
Il chiamante passato in un argomento puntatore non valido. |
|
Memoria insufficiente per allocare il valore BSTR. |
Commenti
L'applicazione deve usare SysFreeString per liberare la memoria allocata per il parametro ppRequestID .
Questa funzione può inviare dati in transito in formato non crittografato; pertanto, un utente che esegue l'intercettazione sulla rete potrebbe essere in grado di leggere i dati. Il rischio di sicurezza di inviare i dati in testo non crittografato deve essere considerato prima di usare questo metodo.
Requisiti
| Piattaforma di destinazione | Windows |
| Intestazione | mdhcp.h |
| Libreria | Uuid.lib |
| DLL | Mdhcp.dll |