PeerGroupSetProperties 関数 (p2p.h)
PeerGroupSetProperties 関数は、現在のピア グループのプロパティを設定します。 この API のバージョン 1.0 では、ピア グループの作成者のみがこの操作を実行できます。
構文
NOT_BUILD_WINDOWS_DEPRECATE HRESULT PeerGroupSetProperties(
[in] HGROUP hGroup,
[in] PPEER_GROUP_PROPERTIES pProperties
);
パラメーター
[in] hGroup
ピアによってプロパティが設定されているピア グループを処理します。 このハンドルは、 PeerGroupCreate、 PeerGroupOpen、または PeerGroupJoin 関数によって返されます。 このパラメーターは必須です。
[in] pProperties
新しいプロパティを含むピアによって設定された PEER_GROUP_PROPERTIES 構造体へのポインター。 この構造を取得するには、ピアが最初に PeerGroupGetProperties を呼び出し、適切なフィールドを変更してから、このパラメーターとして渡す必要があります。 このパラメーターは必須です。
PEER_GROUP_PROPERTIESの次のメンバーは変更できません。
- dwSize
- pwzCloud
- pwzClassifier
- pwzGroupPeerName
- pwzCreatorPeerName
戻り値
操作 が成功した場合S_OK を返します。 それ以外の場合、関数は次のいずれかの値を返します。
| リターン コード | 説明 |
|---|---|
|
操作を完了するのに十分なメモリがありません。 |
|
グループは、ピア グループのプロパティを設定できる状態ではありません。 たとえば、 PeerGroupJoin が呼び出されましたが、ピア グループ データベースとの同期は完了していません。 |
|
ピア グループへのハンドルが無効です。 |
|
指定された 1 つ以上のプロパティが無効です。 |
|
現在の ID には、これらのプロパティを変更する権限がありません。 この場合、ID はピア グループの作成者ではありません。 |
|
指定されたパスワードがシステム パスワードの要件を満たしていません。 |
暗号化固有のエラーは、 Microsoft RSA ベース プロバイダーから返すことができます。 これらのエラーの前には CRYPT_* が付き、Winerror.h で定義されています。
注釈
パスワードを使用するアプリケーションでは、 CryptoProtectMemory 関数と SecureZeroMemory 関数を呼び出して、パスワードを安全に処理することをお勧めします。
要件
| 要件 | 値 |
|---|---|
| サポートされている最小のクライアント | WINDOWS XP と SP2 [デスクトップ アプリのみ]、Windows XP SP1 と Advanced Networking Pack forWindows XP |
| サポートされている最小のサーバー | サポートなし |
| 対象プラットフォーム | Windows |
| ヘッダー | p2p.h |
| Library | P2P.lib |
| [DLL] | P2P.dll |