PeerGroupIssueCredentials-Funktion (p2p.h)

Artikel
08/25/2023

Die PeerGroupIssueCredentials-Funktion stellt Anmeldeinformationen, einschließlich eines GMC, für eine bestimmte Identität aus und gibt optional eine XML-Einladungszeichenfolge zurück, die der eingeladene Peer verwenden kann, um einer Peergruppe beizutreten.

Syntax

NOT_BUILD_WINDOWS_DEPRECATE HRESULT PeerGroupIssueCredentials(
  [in]  HGROUP               hGroup,
  [in]  PCWSTR               pwzSubjectIdentity,
  [in]  PEER_CREDENTIAL_INFO *pCredentialInfo,
  [in]  DWORD                dwFlags,
  [out] PWSTR                *ppwzInvitation
);

Parameter

[in] hGroup

Behandeln Sie eine Peergruppe, für die ein Peer Anmeldeinformationen an potenzielle eingeladene Peers ausgibt. Dieses Handle wird von der Funktion PeerGroupCreate, PeerGroupOpen oder PeerGroupJoin zurückgegeben. Dieser Parameter ist erforderlich.

[in] pwzSubjectIdentity

Gibt die Identität eines Peers an, für den Anmeldeinformationen ausgestellt werden. Dieser Parameter ist erforderlich.

[in] pCredentialInfo

PEER_CREDENTIAL_INFO Struktur, die Informationen zu den Anmeldeinformationen eines Peers enthält, dessen Identität in pwzSubjectIdentity angegeben ist. Wenn dieser Parameter NULL ist, werden stattdessen die in der Peerdatenbank gespeicherten Informationen verwendet. Dieser Parameter ist optional.

Wenn dieser Parameter angegeben wird, werden die folgenden Felder in PEER_CREDENTIAL_INFO ignoriert:

pwzIssuerPeerName
pwzIssuerFriendlyName

[in] dwFlags

Gibt eine Reihe von Flags an, die verwendet werden, um Aktionen zu beschreiben, die bei der Ausstellung von Anmeldeinformationen ausgeführt werden. Wenn dieser Parameter auf 0 (null) festgelegt ist, werden die Anmeldeinformationen in ppwzInvitation zurückgegeben. Dieser Parameter ist optional.

Wert	Bedeutung
PEER_GROUP_STORE_CREDENTIALS	Veröffentlichen Sie die neu erstellte GMC der Antragstelleridentität in der Gruppendatenbank. Der GMC wird automatisch vom Betreff aufgenommen. Wenn dieses Flag nicht festgelegt ist, müssen die Anmeldeinformationen von einer anderen Anwendung wie E-Mail abgerufen werden.

[out] ppwzInvitation

Zeiger auf eine XML-Einladungszeichenfolge, die vom Funktionsaufruf zurückgegeben wird. Diese Einladung wird out-of-band an den eingeladenen Peer übergeben, der sie in einem Aufruf von PeerGroupJoin verwendet. Dieser Parameter ist optional.

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 verfügbar, um den Vorgang abzuschließen.
PEER_E_IDENTITY_DELETED	Die Identität, die die Anmeldeinformationen erstellt, wurde gelöscht.
PEER_E_IDENTITY_NOT_FOUND	Die Identität kann nicht in der Gruppendatenbank gefunden werden, und pCredentialInfo ist NULL.
PEER_E_NO_KEY_ACCESS	Der Zugriff auf die Identitäts- oder Gruppenschlü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 wurde.

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

Hinweise

Diese Funktion kann nur von einem Administrator erfolgreich aufgerufen werden.

Die Anmeldeinformationen für ein Element (PEER_CREDENTIAL_INFO) werden durch Aufrufen von PeerGroupEnumMembers abgerufen. Die Anmeldeinformationen befinden sich im Feld pCredentialInfo der PEER_MEMBER-Struktur für ein bestimmtes Element.

Anforderungen

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

Freigeben über