Méthode IWSDTransportAddress::GetTransportAddressEx (wsdbase.h)

Article
08/28/2023

Obtient un pointeur vers une représentation sous forme de chaîne de l’objet d’adresse. Le format de la chaîne varie et est déterminé par l’interface d’implémentation ( IWSDHttpAddress ou IWSDUdpAddress).

Syntaxe

HRESULT GetTransportAddressEx(
  [in]  BOOL    fSafe,
  [out] LPCWSTR *ppszAddress
);

Paramètres

[in] fSafe

Spécifie si l’identificateur d’étendue d’une adresse IPv6 est inclus dans la chaîne ppszAddress retournée. Par exemple, si l’objet d’adresse représente une adresse locale de lien IPv6 et que fSafe a la valeur FALSE, l’identificateur d’étendue IPv6 est inclus dans la chaîne ppszAddress retournée.

Si l’objet address représente une adresse IPv4 ou un nom d’hôte, ce paramètre est ignoré.

[out] ppszAddress

Représentation sous forme de chaîne de l’objet d’adresse. Ne libérez pas ce pointeur.

Valeur retournée

Cette méthode peut retourner l’une de ces valeurs.

Les valeurs de retour possibles incluent, sans s’y limiter, les éléments suivants.

Code de retour	Description
S_OK	Méthode terminée avec succès.
E_POINTER	ppszAddress a la valeur NULL.
S_FALSE	L’adresse de transport n’a pas encore été définie. Pour définir l’adresse de transport, appelez SetTransportAddress avec une adresse non NULL .

Remarques

La chaîne retournée par cette méthode peut contenir une adresse IPv4 ou IPv6 non freinée, telle que « fe80::1 ». Il peut également contenir une adresse IPv6 entre crochets qui inclut le port tel que « [fe80::1]:1234 ». L’appelant doit analyser soigneusement la chaîne pour tenir compte des deux possibilités.

Spécifications


Client minimal pris en charge	Windows Vista [applications de bureau uniquement]
Serveur minimal pris en charge	Windows Server 2008 [applications de bureau uniquement]
Plateforme cible	Windows
En-tête	wsdbase.h (inclure Wsdapi.h)
DLL	Wsdapi.dll

Voir aussi

IWSDTransportAddress

Partager via