PeerCollabRegisterApplication 関数 (p2p.h)

PeerCollabRegisterApplication 関数は、ピアコラボレーションアクティビティで起動できるように、アプリケーションをローカルコンピューターに登録します。

構文

NOT_BUILD_WINDOWS_DEPRECATE HRESULT PeerCollabRegisterApplication(
  [in] PCPEER_APPLICATION_REGISTRATION_INFO pcApplication,
  [in] PEER_APPLICATION_REGISTRATION_TYPE   registrationType
);

パラメーター

[in] pcApplication

ピアのアプリケーション機能セットの UUID と、追加のピア固有データを含むPEER_APPLICATION_REGISTRATION_INFO構造体へのポインター。

[in] registrationType

ピアのアプリケーションが 現在のユーザー に登録されているか、ピアのマシン のすべてのユーザー に登録されているかを示すPEER_APPLICATION_REGISTRATION_TYPE値。

戻り値

関数が成功した場合S_OKを返します。それ以外の場合、関数は次のいずれかの値を返します。

リターンコード	説明
E_OUTOFMEMORY	この操作をサポートするのに十分なメモリがありません。
E_INVALIDARG	引数の 1 つが無効です。

注釈

アプリケーションは、ピアのエンドポイントで使用できるソフトウェアまたはソフトウェア機能のセットです。一般に、これは、ゲームやその他の共同作業アプリケーションなどのピアネットワークアクティビティをサポートするソフトウェアパッケージを指します。

コラボレーションインフラストラクチャは、信頼された連絡先または "People Near Me" からアプリケーションの招待を受け取ることができます。これは、コラボレーションインフラストラクチャが PeerCollabSignin を使用してサインインするスコープに基づいています。

ピアのアプリケーションには、1 つの特定のアプリケーションを表す GUID があります。アプリケーションがピアに登録されると、この GUID と対応するアプリケーションをピアのすべての信頼できる連絡先が使用できるようになります。これは、ピアが参加できるアクティビティを示します。ピアのアプリケーションの登録を解除するには、この GUID を使用して PeerCollabUnregisterApplication を呼び出します。

アプリケーションを登録する場合、開発者は絶対パスではなく、 %ProgramFiles%などの相対パスを指定することをお勧めします。これにより、アプリケーションファイルの場所が変更されたためにアプリケーションが失敗するのを防ぐことができます。たとえば、 C:\ProgramFiles ディレクトリが E:\ に移動された場合です。

マシンに対してローカルなアプリケーションのみを登録できます。アプリケーションの実行可能パスが UNC パスやローカルマップされたネットワークドライブなどのネットワーク共有に配置されている場合は、登録できません。

アプリケーションは、"ALL_USERS" スコープと "CURRENT_USER" スコープに登録できます。アプリケーションが両方のスコープに同時に登録された場合、'CURRENT_USER' スコープに登録されているアプリケーションが、'ALL_USERS' スコープに登録されているアプリケーションよりも優先されます。 'ALL_USERS' の登録の種類に登録するには、呼び出し元が管理特権で動作している必要があることに注意してください。

特定の registrationType に登録できるアプリケーションの最大数は 64 です。

要件

要件	値
サポートされている最小のクライアント	Windows Vista [デスクトップアプリのみ]
サポートされている最小のサーバー	サポートなし
対象プラットフォーム	Windows
ヘッダー	p2p.h
Library	P2P.lib
[DLL]	P2P.dll