PeerGroupCreateInvitation-Funktion (p2p.h)

Artikel
08/25/2023

Die PeerGroupCreateInvitation-Funktion gibt eine XML-Zeichenfolge zurück, die vom angegebenen Peer verwendet werden kann, um einer Gruppe beizutreten.

Syntax

NOT_BUILD_WINDOWS_DEPRECATE HRESULT PeerGroupCreateInvitation(
  [in]  HGROUP     hGroup,
  [in]  PCWSTR     pwzIdentityInfo,
  [in]  FILETIME   *pftExpiration,
  [in]  ULONG      cRoles,
  [in]  const GUID *pRoles,
  [out] PWSTR      *ppwzInvitation
);

Parameter

[in] hGroup

Handle an die Peergruppe, für die diese Einladung ausgestellt wird. Dieses Handle wird von der Funktion PeerGroupCreate, PeerGroupOpen oder PeerGroupJoin zurückgegeben. Dieser Parameter ist erforderlich.

[in] pwzIdentityInfo

Zeiger auf eine Unicode-Zeichenfolge, die das XML-Blob (einschließlich des GMC) enthält, das von einem vorherigen Aufruf von PeerIdentityGetXML mit der Identität des Peers zurückgegeben wurde. Alternativ kann dieser Parameter einen Zeiger auf ein XML-Blob enthalten, das von PeerIdentityGetXML mithilfe der Peerinformationen in PEER_CONTACT generiert wird, um eine Einladung für einen Peerkontakt zu generieren.

[in] pftExpiration

Gibt eine UTC FILETIME-Struktur an, die das spezifische Datum und die Uhrzeit des Ablaufs der Einladung enthält. Dieser Wert darf nicht größer als die verbleibende Lebensdauer des ausstellenden Peers sein. Wenn dieser Parameter NULL ist, wird die Lebensdauer der Einladung auf den maximal möglichen Wert festgelegt– die verbleibende Lebensdauer des Peers.

[in] cRoles

Gibt die Anzahl der Rollen in pRoleInfo an.

[in] pRoles

Zeiger auf eine Liste von GUIDs, die den kombinierten Satz verfügbarer Rollen angibt. Die verfügbaren Rollen sind wie folgt:

Wert	Bedeutung
PEER_GROUP_ROLE_ADMIN	Diese Rolle kann Einladungen ausgeben, Anmeldeinformationen ausstellen und den GMC anderer Administratoren erneuern sowie sich als Mitglied der Peergruppe verhalten.
PEER_GROUP_ROLE_MEMBER	Diese Rolle kann Datensätze in der Gruppendatenbank veröffentlichen.

[out] ppwzInvitation

Zeiger auf eine Unicode-Zeichenfolge, die die Einladung des Ausstellers enthält. Diese Einladung kann vom Empfänger an PeerGroupJoin übergeben werden, um der angegebenen Peergruppe beizutreten. Um die Details der Einladung als PEER_INVITATION_INFO-Struktur zurückzugeben, übergeben Sie diese Zeichenfolge an PeerGroupParseInvitation. Um diese Daten freizugeben, übergeben Sie diesen Zeiger an PeerFreeData.

Rückgabewert

Gibt S_OK zurück, wenn der Vorgang erfolgreich ist. Andernfalls gibt die Funktion einen der folgenden Werte zurück.

Rückgabecode	Beschreibung
E_INVALIDARG	Einer der Parameter ist ungültig.
E_OUTOFMEMORY	Es ist nicht genügend Arbeitsspeicher vorhanden, um den angegebenen Vorgang auszuführen.
PEER_E_GROUP_NOT_READY	Die Peergruppe befindet sich nicht in einem Zustand, in dem Datensätze hinzugefügt werden können. Beispielsweise wird PeerGroupJoin aufgerufen, aber die Synchronisierung mit der Gruppendatenbank wurde noch nicht abgeschlossen.
PEER_E_CHAIN_TOO_LONG	Die GMC-Kette ist länger als 24 Administratoren oder Mitglieder. Weitere Informationen zu GMC-Ketten finden Sie in der Dokumentation Zur Funktionsweise von Gruppensicherheit .
PEER_E_IDENTITY_DELETED	Die als pwzIdentityInfo übergebenen Daten gelten für eine gelöschte Identität und sind nicht mehr gültig.
PEER_E_NOT_AUTHORIZED	Der Peer, der diese Methode aufgerufen hat, ist kein Administrator.
PEER_E_NO_KEY_ACCESS	Der Zugriff auf die Identitäts- oder Peergruppenschlüssel wird verweigert. Dies wird in der Regel durch eine falsche Zugriffssteuerungsliste (Access Control List, ACL) für den Ordner verursacht, der die Benutzer- oder Computerschlüssel enthält. Dies kann passieren, wenn die ACL manuell zurückgesetzt wird.

Kryptografiespezifische Fehler können vom Microsoft RSA-Basisanbieter zurückgegeben werden. Diesen Fehlern wird CRYPT_* vorangestellt und in Winerror.h definiert.

Hinweise

Peers können keine Einladungen für Peers erstellen, deren angenommene Rolle ihrer eigenen überlegen ist. Beispielsweise kann ein Peer in einer Mitgliedsrolle keine Einladung für einen Peer in einer Administratorrolle erstellen.

Anforderungen

Anforderung	Wert
Unterstützte Mindestversion (Client)	Windows XP mit SP2 [nur Desktop-Apps],Windows XP mit SP1 mit dem Erweiterten Netzwerkpaket fürWindows XP
Unterstützte Mindestversion (Server)	Nicht unterstützt
Zielplattform	Windows
Kopfzeile	p2p.h
Bibliothek	P2P.lib
DLL	P2P.dll

Weitere Informationen

PEER_CONTACT

PeerGroupParseInvitation

PeerIdentityGetXML

Freigeben über