Metodo IUPnPRegistrar::GetUniqueDeviceName (upnphost.h)
Il metodo GetUniqueDeviceName recupera il nome UDN per il dispositivo specificato. Il nome UDN è stato generato dall'host del dispositivo per ogni dispositivo incorporato. L'UDN del modello nella descrizione del dispositivo viene sostituito da questo nome utente generato per ogni dispositivo incorporato quando il dispositivo viene registrato. Questo metodo è re-entrante.
Sintassi
HRESULT GetUniqueDeviceName(
[in] BSTR bstrDeviceIdentifier,
[in] BSTR bstrTemplateUDN,
[out] BSTR *pbstrUDN
);
Parametri
[in] bstrDeviceIdentifier
Specifica l'identificatore restituito da RegisterDevice o RegisterRunningDevice.
[in] bstrTemplateUDN
Specifica il nome UDN dal modello di descrizione del dispositivo.
[out] pbstrUDN
Riceve il nome UDN del dispositivo generato dall'host del dispositivo.
Valore restituito
Se il metodo ha esito positivo, il valore restituito è S_OK. In caso contrario, il metodo restituisce uno dei codici di errore COM definiti in WinError.h.
Commenti
Ogni nome UDN specificato per un dispositivo nel modello di descrizione del dispositivo viene sostituito durante la registrazione. L'host del dispositivo sostituisce ogni nome UDN con uno univoco globale.
Requisiti
Requisito | Valore |
---|---|
Client minimo supportato | Windows XP [solo app desktop] |
Server minimo supportato | Nessuno supportato |
Piattaforma di destinazione | Windows |
Intestazione | upnphost.h |
DLL | Upnphost.dll |