IUPnPRemoteEndpointInfo ::GetStringValue, méthode (upnphost.h)
La méthode GetStringValue obtient une chaîne qui fournit des informations sur une demande ou un demandeur.
Syntaxe
HRESULT GetStringValue(
[in] BSTR bstrValueName,
[out] BSTR *pbstrValue
);
Paramètres
[in] bstrValueName
Chaîne qui spécifie la catégorie d’informations à récupérer.
[out] pbstrValue
Pointeur vers une chaîne dont la signification dépend de la valeur de bstrValueName.
Si bstrValueName est « RemoteAddress », la chaîne est l’adresse IP du demandeur. Windows 7 : Pour récupérer l’en-tête HTTP UserAgent, définissez bstrValueName sur « HttpUserAgent ».
Valeur retournée
Si la méthode réussit, la valeur de retour est S_OK. Sinon, la méthode retourne l’un des codes d’erreur COM définis dans WinError.h.
Remarques
Actuellement, les seules valeurs valides pour le paramètre bstrValueName sont « RemoteAddress » et (Windows 7 uniquement) « HttpUserAgent ». Pour toute autre valeur, cette méthode retourne le code d’erreur COM E_INVALIDARG.
Configuration requise
Condition requise | Valeur |
---|---|
Client minimal pris en charge | Windows Vista, Windows XP avec SP2 [applications de bureau uniquement] |
Serveur minimal pris en charge | Aucun pris en charge |
Plateforme cible | Windows |
En-tête | upnphost.h |
DLL | Upnphost.dll |