PFNPEER_SECURE_RECORD Rückruffunktion (p2p.h)

  • Artikel

Der PFNPEER_SECURE_RECORD-Rückruf gibt die Funktion an, die die Peer graphing Infrastructure aufruft, um Datensätze zu schützen.

Syntax

PFNPEER_SECURE_RECORD PfnpeerSecureRecord;

HRESULT PfnpeerSecureRecord(
  [in]  HGRAPH hGraph,
  [in]  PVOID pvContext,
  [in]  PPEER_RECORD pRecord,
  [in]  PEER_RECORD_CHANGE_TYPE changeType,
  [out] PPEER_DATA *ppSecurityData
)
{...}

Parameter

[in] hGraph

Gibt das Peerdiagramm an, das dem angegebenen Datensatz zugeordnet ist.

[in] pvContext

Zeiger auf den Sicherheitskontext. Dieser Parameter verweist auf das element pvContext der PEER_SECURITY_INTERFACE-Struktur .

[in] pRecord

Zeiger auf den zu sichernden Datensatz.

[in] changeType

Gibt den Grund an, aus dem die Überprüfung erfolgen muss. PEER_RECORD_CHANGE_TYPE listet die gültigen Werte auf.

[out] ppSecurityData

Gibt die Sicherheitsdaten für diesen Datensatz an. Diese Daten werden freigegeben, indem die Methode aufgerufen wird, die im pfnFreeSecurityData-Member des PEER_SECURITY_INTERFACE angegeben ist, nachdem die Daten kopiert und dem Datensatz hinzugefügt wurden.

Rückgabewert

Wenn dieser Rückruf erfolgreich ist, wird der Rückgabewert S_OK.

Hinweise

Dieser Rückruf wird immer dann aufgerufen, wenn eine Anwendung eine der Methoden aufruft, die Datensätze ändern, z. B. PeerGraphAddRecord oder PeerGraphUpdateRecord. Dieser Rückruf
sollte Daten erstellen, die für diesen Datensatz spezifisch sind, z. B. eine kleine digitale Signatur, und diese über den ppSecurityData-Parameter zurückgeben. Diese Daten werden dann dem Datensatz im securityData-Member hinzugefügt und von der Methode überprüft, die vom pfnValidateRecord-Member des PEER_SECURITY_INTERFACE angegeben wird.

Hinweis Dieser Prozess erfolgt sowohl auf dem lokalen Computer als auch auf jedem Peer, der mit dem Diagramm verbunden ist, wenn der Peer den Datensatz empfängt.
 
Wenn der durch den changeType-Parameter angegebene Vorgang nicht zulässig ist, sollte der Rückruf anstelle von S_OK einen Fehlercode wie PEER_E_NOT_AUTHORIZED zurückgeben.

Dieser Rückruf kann von allen Funktionen der Peer graphing-API aufgerufen werden, die Datensätze umfassen, z. B. PeerGraphUpdateRecord.

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

Weitere Informationen

PEER_DATA

PEER_RECORD

PEER_RECORD_CHANGE_TYPE

PEER_SECURITY_INTERFACE