IWSDTransportAddress::GetTransportAddressEx-Methode (wsdbase.h)

  • Artikel

Ruft einen Zeiger auf eine Zeichenfolgendarstellung des Adressobjekts ab. Das Format der Zeichenfolge variiert und wird durch die implementierende Schnittstelle (entweder IWSDHttpAddress oder IWSDUdpAddress) bestimmt.

Syntax

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

Parameter

[in] fSafe

Gibt an, ob der Bereichsbezeichner für eine IPv6-Adresse in der zurückgegebenen ppszAddress-Zeichenfolge enthalten ist. Wenn das Adressobjekt beispielsweise eine lokale IPv6-Linkadresse darstellt und fSafefalse ist, wird der IPv6-Bereichsbezeichner in die zurückgegebene ppszAddress-Zeichenfolge eingeschlossen.

Wenn das Adressobjekt eine IPv4-Adresse oder einen Hostnamen darstellt, wird dieser Parameter ignoriert.

[out] ppszAddress

Zeichenfolgendarstellung des Adressobjekts. Heben Sie die Zuordnung dieses Zeigers nicht auf.

Rückgabewert

Diese Methode kann einen dieser Werte zurückgeben.

Mögliche Rückgabewerte sind u. a. die folgenden:

Rückgabecode BESCHREIBUNG
S_OK
 Die Methode wurde erfolgreich abgeschlossen.
E_POINTER
 ppszAddress ist NULL.
S_FALSE
 Die Transportadresse wurde noch nicht festgelegt. Um die Transportadresse festzulegen, rufen Sie SetTransportAddress mit einer Nicht-NULL-Adresse auf.

Hinweise

Die von dieser Methode zurückgegebene Zeichenfolge kann eine IPv4- oder nicht abgebremste IPv6-Adresse wie "fe80::1" enthalten. Es kann auch eine IPv6-Adresse in Klammern enthalten, die den Port wie "[fe80::1]:1234" enthält. Der Aufrufer sollte die Zeichenfolge sorgfältig analysieren, um beide Möglichkeiten zu berücksichtigen.

Anforderungen

   
Unterstützte Mindestversion (Client) Windows Vista [nur Desktop-Apps]
Unterstützte Mindestversion (Server) Windows Server 2008 [nur Desktop-Apps]
Zielplattform Windows
Kopfzeile wsdbase.h (include Wsdapi.h)
DLL Wsdapi.dll

Weitere Informationen

IWSDTransportAddress