Metodo IUPnPDeviceControl::Initialize (upnphost.h)
Il metodo Initialize viene utilizzato per inizializzare il dispositivo. L'host del dispositivo richiama questo metodo.
Sintassi
HRESULT Initialize(
[in] BSTR bstrXMLDesc,
[in] BSTR bstrDeviceIdentifier,
[in] BSTR bstrInitString
);
Parametri
[in] bstrXMLDesc
Specifica la descrizione completa del dispositivo XML, come pubblicato dall'host del dispositivo. La descrizione del dispositivo è basata sul modello fornito dal dispositivo.
[in] bstrDeviceIdentifier
Identifica il dispositivo da inizializzare. Si tratta dello stesso identificatore restituito da IUPnPRegistrar::RegisterDevice o IUPnPRegistrar::RegisterRunningDevice. Viene usato anche per recuperare l'UDN del dispositivo usando IUPnPRegistrar::GetUniqueDeviceName.
[in] bstrInitString
Specifica la stringa di inizializzazione utilizzata quando il dispositivo è stato registrato.
Valore restituito
Quando si implementa questo metodo, restituire S_OK se il metodo ha esito positivo. In caso contrario, restituire uno dei codici di errore COM definiti in WinError.h.
Commenti
Questo metodo viene richiamato immediatamente dopo la creazione di un'istanza dell'oggetto controllo dispositivo. Deve essere richiamato prima che venga richiamato IUPnPDeviceControl::GetServiceObject .
La differenza tra un dispositivo in esecuzione e un dispositivo non in esecuzione è quando viene richiamato il metodo Initialize .
Per i dispositivi in esecuzione, Initialize viene richiamato quando viene richiamato IUPnPRegistrar::RegisterRunningDevice e l'inizializzazione viene completata prima che IUPnPRegistrar::RegisterRunningDevice restituisca.
Per i dispositivi non in esecuzione, Initialize non viene necessariamente richiamato quando viene richiamato IUPnPRegistrar::RegisterDevice . L'inizializzazione viene richiamata all'arrivo del primo controllo o della richiesta di evento.
BstrDeviceIdentifier può essere usato anche per chiamare IUPnPRegistrar::GetUniqueDeviceName.
Requisiti
| Client minimo supportato | Windows XP [solo app desktop] |
| Server minimo supportato | Nessuno supportato |
| Piattaforma di destinazione | Windows |
| Intestazione | upnphost.h |
| DLL | Upnphost.dll |