次の方法で共有

PeerCollabEnumApplicationRegistrationInfo 関数 (p2p.h)

  • [アーティクル]

PeerCollabEnumApplicationRegistrationInfo 関数は、ピア アプリケーション情報の取得に使用される列挙ハンドルを取得します。

構文

NOT_BUILD_WINDOWS_DEPRECATE HRESULT PeerCollabEnumApplicationRegistrationInfo(
  [in]  PEER_APPLICATION_REGISTRATION_TYPE registrationType,
  [out] HPEERENUM                          *phPeerEnum
);

パラメーター

[in] registrationType

ピアのアプリケーションを現在のユーザーに登録するか、ピアのコンピューターのすべてのユーザーに登録するかを指定するPEER_APPLICATION_REGISTRATION_TYPE値。

[out] phPeerEnum

ピア アプリケーション登録情報のピア列挙ハンドルへのポインター。 このデータは、このハンドルを PeerGetNextItem に渡すことによって取得されます。

戻り値

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

リターン コード 説明
E_OUTOFMEMORY
 この操作をサポートするのに十分なメモリがありません。
E_INVALIDARG
 引数の 1 つが無効です。
PEER_E_NOT_INITIALIZED
 Windows ピア インフラストラクチャが初期化されていません。 関連する初期化関数を呼び出す必要があります。

注釈

個々のピア アプリケーションを取得するには、返されたハンドルを PeerGetNextItem に渡します。 PEER_APPLICATION_REGISTRATION_INFO構造体の配列が返されます。 列挙を閉じ、関連付けられているリソースを解放するには、このハンドルを PeerEndEnumeration に渡します。 列挙によって返される個々の項目は、 PeerFreeData を使用して解放する必要があります。

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

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

ピア アプリケーション登録情報項目は、個々の PEER_APPLICATION_REGISTRATION_INFO 構造体として返されます。

要件

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

こちらもご覧ください

PEER_APPLICATION_REGISTRATION_INFO

PEER_APPLICATION_REGISTRATION_TYPE

ピア コラボレーション API 関数

PeerCollabUnregisterApplication