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 配列内の項目数。 ppHostAddresses が IWSDAddress インターフェイスの場合、count は 1 である必要があります。
戻り値
可能な戻り値には、次のものが含まれますが、これらに限定されません。
リターン コード | 説明 |
---|---|
|
メソッドは正常に完了しました。 |
|
pszLocalId が NULL、 pszLocalId の文字数がWSD_MAX_TEXT_LENGTH (8192) を超えているか、 ppHostAddresses によって参照されるアドレスの数が dwHostAddressCount と一致しません。 |
|
デバイス ホストが予期しない状態です。 |
|
操作を完了するにはメモリが不足しています。 |
|
初期化を完了できませんでした。 |
注釈
このメソッドは WSDCreateDeviceHost によって呼び出され、通常はコードによって直接呼び出される必要はありません。
要件
要件 | 値 |
---|---|
サポートされている最小のクライアント | Windows Vista [デスクトップ アプリのみ] |
サポートされている最小のサーバー | Windows Server 2008 [デスクトップ アプリのみ] |
対象プラットフォーム | Windows |
ヘッダー | wsdhost.h (Wsdapi.h を含む) |
[DLL] | Wsdapi.dll |