PeerIdentityCreate-Funktion (p2p.h)
Die PeerIdentityCreate-Funktion erstellt eine neue Peeridentität und gibt ihren Namen zurück. Der Name der Peeridentität muss in allen nachfolgenden Aufrufen der Funktionen Peer Identity Manager, Peergruppierung oder PNRP übergeben werden, die im Auftrag der Peeridentität ausgeführt werden. Der Name der Peeridentität gibt an, welche Peeridentität verwendet wird.
Syntax
NOT_BUILD_WINDOWS_DEPRECATE HRESULT PeerIdentityCreate(
[in] PCWSTR pwzClassifier,
[in] PCWSTR pwzFriendlyName,
[in] HCRYPTPROV hCryptProv,
[out] PWSTR *ppwzIdentity
);
Parameter
[in] pwzClassifier
Gibt den Klassifizierer an, der an den Namen der veröffentlichten Peeridentität angefügt werden soll. Diese Zeichenfolge ist eine Unicode-Zeichenfolge und kann NULL sein. Diese Zeichenfolge darf nur 150 Zeichen lang sein, einschließlich des NULL-Abschlusszeichens .
[in] pwzFriendlyName
Gibt den Anzeigenamen der Peeridentität an. Dies ist eine Unicode-Zeichenfolge und kann NULL sein. Diese Zeichenfolge darf nur 256 Zeichen lang sein, einschließlich des NULL-Abschlusszeichens . Wenn pwzFriendlyNameNULL ist, ist der Name der Identität der Anzeigename. Der Anzeigename ist optional und muss nicht eindeutig sein.
[in] hCryptProv
Handle an den Kryptografiedienstanbieter (Cryptographic Service Provider, CSP), der ein AT_KEYEXCHANGE Schlüsselpaar mit einer Länge von mindestens 1024 Bit enthält. Dieses Schlüsselpaar wird als Grundlage für eine neue Peeridentität verwendet. Wenn hCryptProv null (0) ist, wird ein neues Schlüsselpaar für die Peeridentität generiert.
[out] ppwzIdentity
Empfängt einen Zeiger auf den Namen einer erstellten Peeridentität. Dieser Name muss bei allen nachfolgenden Aufrufen der Funktionen Peer Identity Manager, Peergruppierung oder PNRP verwendet werden, die im Auftrag der Peeridentität ausgeführt werden. Gibt NULL zurück, wenn die Peeridentität nicht erstellt werden kann.
Rückgabewert
Wenn der Funktionsaufruf erfolgreich ist, wird der Rückgabewert S_OK. Andernfalls wird einer der folgenden Werte zurückgegeben.
| Rückgabecode | Beschreibung |
|---|---|
|
Das Handle für den schlüssel, der von hCryptProv angegeben wird, ist ungültig. |
|
Einer der Parameter ist ungültig. |
|
Es ist nicht genügend Arbeitsspeicher vorhanden, um den angegebenen Vorgang auszuführen. |
|
Die Peeridentität ist bereits vorhanden. Tritt nur auf, wenn eine Peeridentität basierend auf dem angegebenen Schlüssel und Klassifizierer bereits vorhanden ist. |
|
Der Zugriff auf die Peeridentität 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 wurde. |
|
Die Peeridentität kann nicht erstellt werden, da zu viele Peeridentitäten vorhanden sind. |
Hinweise
Das Schlüsselpaar und der Klassifizierer werden verwendet, um den Peernamen einer neuen Peeridentität zu generieren. Nachdem eine Peeridentität erstellt wurde, wird sie automatisch auf dem Datenträger gespeichert.
Der Name der Identität sollte mithilfe von PeerFreeData freigegeben werden. Dadurch wird die Peeridentität nicht gelöscht. Verwenden Sie zum Löschen der Identität die Funktion PeerIdentityDelete .
Wenn hCryptProv nicht NULL ist, kann es mithilfe von CryptReleaseContext freigegeben werden, nachdem der Aufruf zurückgegeben wurde.
Anforderungen
| Anforderung | Wert |
|---|---|
| Unterstützte Mindestversion (Client) | Windows XP mit SP2 [nur Desktop-Apps],Windows XP mit SP1 mit dem Advanced Networking Pack für Windows XP |
| Unterstützte Mindestversion (Server) | Nicht unterstützt |
| Zielplattform | Windows |
| Kopfzeile | p2p.h |
| Bibliothek | P2P.lib |
| DLL | P2P.dll |