IWSDTransportAddress::GetTransportAddressEx メソッド (wsdbase.h)
アドレス オブジェクトの文字列表現へのポインターを取得します。 文字列の形式は異なり、実装インターフェイス ( IWSDHttpAddress または IWSDUdpAddress) によって決まります。
構文
HRESULT GetTransportAddressEx(
[in] BOOL fSafe,
[out] LPCWSTR *ppszAddress
);
パラメーター
[in] fSafe
返される ppszAddress 文字列に IPv6 アドレスのスコープ識別子を含めるかどうかを指定します。 たとえば、アドレス オブジェクトが IPv6 リンク ローカル アドレスを表し、 fSafe が FALSE の場合、IPv6 スコープ識別子は返される ppszAddress 文字列に含まれます。
アドレス オブジェクトが IPv4 アドレスまたはホスト名を表す場合、このパラメーターは無視されます。
[out] ppszAddress
アドレス オブジェクトの文字列表現。 このポインターの割り当てを解除しないでください。
戻り値
このメソッドは、これらの値のいずれかを返すことができます。
可能な戻り値には、次のものが含まれますが、これらに限定されません。
リターン コード | 説明 |
---|---|
|
メソッドは正常に完了しました。 |
|
ppszAddress は NULL です。 |
|
トランスポート アドレスはまだ設定されていません。 トランスポート アドレスを設定するには、NULL 以外のアドレスで SetTransportAddress を呼び出します。 |
解説
このメソッドによって返される文字列には、"fe80::1" などの IPv4 アドレスまたは非区切り IPv6 アドレスが含まれる場合があります。 また、"[fe80::1]:1234" などのポートを含む角かっこで囲まれた IPv6 アドレスを含めることもできます。 呼び出し元は、両方の可能性を考慮して文字列を慎重に解析する必要があります。
要件
サポートされている最小のクライアント | Windows Vista [デスクトップ アプリのみ] |
サポートされている最小のサーバー | Windows Server 2008 [デスクトップ アプリのみ] |
対象プラットフォーム | Windows |
ヘッダー | wsdbase.h (Wsdapi.h を含む) |
[DLL] | Wsdapi.dll |