次の方法で共有


IWSDDeviceHost::Init メソッド (wsdhost.h)

デバイスのホスト側表現である IWSDDeviceHost オブジェクトのインスタンスを初期化します。

構文

HRESULT Init(
  [in]           LPCWSTR        pszLocalId,
  [in, optional] IWSDXMLContext *pContext,
  [in, optional] IWSDAddress    **ppHostAddresses,
  [in, optional] DWORD          dwHostAddressCount
);

パラメーター

[in] pszLocalId

デバイスの論理アドレスまたは物理アドレス。 論理アドレスは という形式 urn:uuid:{guid}です。 pszLocalId が論理アドレスの場合、ホストは論理アドレスを読み上げ、Resolve または Probe メッセージを受信したときにアドレスを物理アドレスに変換します。

pszLocalId が物理アドレス (http または https でプレフィックス付き URL など) の場合、ホストはアドレスを物理アドレスとして使用し、既定のアドレスではなくそのアドレスでホストします。

セキュリティで保護された通信の場合、 pszLocalId は https のプレフィックスが付いた URL である必要があり、ホストは URL で指定されたポートで SSL/TLS プロトコルを使用します。 このポートは WSDAPI とのセキュリティで保護された接続用に予約されているため、推奨ポートはポート 5358 です。 ポートが指定されていない場合、ホストはポート 443 を使用します。 ホスト ポートは SSL サーバー証明書で構成する必要があります。 ホスト ポートの構成の詳細については、「 HttpSetServiceConfiguration」を参照してください。

URL (http または https) は末尾のスラッシュで終了する必要があります。 URL には、有効な IP アドレスまたはホスト名が含まれている必要があります。

pszLocalId の値の例を次に示します。 有効な値の完全な一覧ではありません。

  • http://192.168.0.1:5357/
  • http://localhost/
  • http://myHostname:5357/
  • https://192.168.0.1:5358/
  • https://myHostname/
  • https://myHostname/myDevice/
  • https://myHostname:5358/

[in, optional] pContext

カスタム メッセージの種類または名前空間を定義する IWSDXMLContext インターフェイス。

[in, optional] ppHostAddresses

単一の IWSDAddress オブジェクトまたは IWSDTransportAddress オブジェクト。 オブジェクトは、ホストがリッスンする必要がある特定のアドレスに関する情報を提供します。

pszLocalId にローカル アドレスが含まれている場合、結果の動作は論理アドレスと指定された物理アドレスの間のマッピングになります (論理アドレスと既定の物理アドレス間のマッピングの代わりに)。

[in, optional] dwHostAddressCount

ppHostAddresses 配列内の項目数。 ppHostAddressesIWSDAddress インターフェイスの場合、count は 1 である必要があります。

戻り値

可能な戻り値には、次のものが含まれますが、これらに限定されません。

リターン コード 説明
S_OK
メソッドは正常に完了しました。
E_INVALIDARG
pszLocalIdNULLpszLocalId の文字数がWSD_MAX_TEXT_LENGTH (8192) を超えているか、 ppHostAddresses によって参照されるアドレスの数が dwHostAddressCount と一致しません。
E_FAIL
デバイス ホストが予期しない状態です。
E_OUTOFMEMORY
操作を完了するにはメモリが不足しています。
E_ABORT
初期化を完了できませんでした。

注釈

このメソッドは WSDCreateDeviceHost によって呼び出され、通常はコードによって直接呼び出される必要はありません。

要件

要件
サポートされている最小のクライアント Windows Vista [デスクトップ アプリのみ]
サポートされている最小のサーバー Windows Server 2008 [デスクトップ アプリのみ]
対象プラットフォーム Windows
ヘッダー wsdhost.h (Wsdapi.h を含む)
[DLL] Wsdapi.dll

こちらもご覧ください

IWSDDeviceHost