PeerCollabSignin 関数は、ホスト型インターネット (サーバーレス プレゼンス) またはサブネット ("People Near Me") ピア コラボレーション ネットワーク プレゼンス プロバイダーにピアをサインインさせます。
構文
NOT_BUILD_WINDOWS_DEPRECATE HRESULT PeerCollabSignin(
[in] HWND hwndParent,
[in] DWORD dwSigninOptions
);
パラメーター
[in] hwndParent
親アプリケーションのサインインに対する Windows ハンドル。
[in] dwSigninOptions
呼び出し 元ピアのプレゼンス プロバイダーのサインイン オプションを含む列挙値をPEER_SIGNIN_FLAGSします。
戻り値
関数が成功した場合は、S_OKを返します。 それ以外の場合、関数は次のいずれかの値を返します。
| リターン コード | 説明 |
|---|---|
|
この操作をサポートするのに十分なメモリがありません。 |
|
引数の 1 つが無効です。 |
|
アプリケーションが PeerCollabStartup を以前に呼び出しませんでした。 |
|
昇格されたプロセスから PeerCollabSignIn を呼び出そうとしました。 |
|
サインインは成功しましたが、現時点では IPv6 アドレスを使用できません。 |
解説
p2phost.exe サービスが実行されていない場合、この関数によって起動されます。
昇格されたプロセスから p2phost.exe サービスを起動しようとすると、エラーが返されます。 その結果、アプリケーションが誤って p2phost.exe に管理特権を付与することによってセキュリティを侵害することはできません。 非対話型モードで p2phost.exe を起動することはできません。これは、受信した招待の Windows ダイアログ ボックスを表示する必要があるためです。
PeerCollabSignin を呼び出すと、ユーザーが自動サインインを承認していない場合、サインイン ユーザー インターフェイスが表示されます。 hwndParent を指定した場合、ユーザー インターフェイス ウィンドウでは親ウィンドウとして hwndParent が使用されます。
ユーザーが "People Near Me" にサインインすると、ユーザーの表示名、コンピューター名、IP アドレスがサブネット上のピアに発行されます。 ユーザーは、必要に応じて公開用の表示画像を指定できます。 PeerCollabSignin が呼び出されていないか、ユーザーがサインアウトした場合、この情報は公開されません。
サインインすると、ユーザーはサブネットにサインインし、対話に使用できるピアの一覧を表示できます。 他のユーザーがサブネット上の "People Near Me" にサインインしていない場合、このリストは空になります。
複数のアプリケーションで、任意の時点でインフラストラクチャを使用できます。 他のアプリケーションではインフラストラクチャを使用できなくなるため、1 つのアプリケーションで PeerCollabSignout を呼び出すのはお勧めしません。 アプリケーションは、ユーザーのサインインとサインアウト、またはマシンがスリープ状態または休止状態になる状況を処理する準備も必要です。
現在、PeerCollabSignin 関数の完了には最大 2 秒が必要です。
表示名は必ずしも一意ではありません。 ユーザーは、対話への招待を受け入れる前に、電子メール、電話、または個人による表示名を使用して、ユーザーの ID を確認する必要があります。
ピア コラボレーション ネットワークからサインアウトするには、同じサインイン オプションセットを使用して PeerCollabSignout を呼び出します。 ユーザーは、ユーザー インターフェイスを使用してサインアウトすることもできます。
要件
| サポートされている最小のクライアント | Windows Vista [デスクトップ アプリのみ] |
| サポートされている最小のサーバー | サポートなし |
| 対象プラットフォーム | Windows |
| ヘッダー | p2p.h |
| Library | P2P.lib |
| [DLL] | P2P.dll |