IUPnPDevice::IconURL-Methode (upnp.h)
Die IconURL-Methode gibt eine URL zurück, aus der ein Symbol des angegebenen Formats geladen werden kann.
Syntax
HRESULT IconURL(
[in] BSTR bstrEncodingFormat,
[in] LONG lSizeX,
[in] LONG lSizeY,
[in] LONG lBitDepth,
[out] BSTR *pbstrIconURL
);
Parameter
[in] bstrEncodingFormat
Gibt den MIME-Typ des Codierungsformats an, das für das Symbol angefordert wird.
[in] lSizeX
Gibt die Breite des Symbols in Pixel an. Standardwerte sind 16, 32 oder 48.
[in] lSizeY
Gibt die Höhe des Symbols in Pixel an. Standardwerte sind 16, 32 oder 48 Pixel.
[in] lBitDepth
Gibt die Bittiefe des Symbols an. Standardwerte sind 8, 16 oder 24.
[out] pbstrIconURL
Empfängt einen Verweis auf eine Zeichenfolge, die die URL enthält, aus der das Symbol geladen werden soll. Geben Sie diese Zeichenfolge mit SysFreeString frei, wenn sie nicht mehr benötigt wird.
Rückgabewert
Wenn die Methode erfolgreich ist, wird der Rückgabewert S_OK. Andernfalls gibt die Methode einen der com-Fehlercodes zurück, die in WinError.h definiert sind.
Hinweise
Eine Anwendung kann beliebige Werte für lSizeX, lSizeY und lBitDepth angeben. Es gibt jedoch keine Garantie, dass ein Symbol mit diesen Spezifikationen vorhanden ist.
Wenn kein übereinstimmende Symbol vorhanden ist, wird die URL für das Symbol zurückgegeben, das der angegebenen Größe und Bittiefe am ehesten entspricht.
Anforderungen
| Unterstützte Mindestversion (Client) | Windows XP [nur Desktop-Apps] |
| Unterstützte Mindestversion (Server) | Nicht unterstützt |
| Zielplattform | Windows |
| Kopfzeile | upnp.h |
| DLL | Upnp.dll |