INapEnforcementClientConnection::SetCorrelationId-Methode

Hinweis

Die Netzwerkzugriffsschutz-Plattform ist ab Windows 10 nicht verfügbar.

Die INapEnforcementClientConnection::SetCorrelationId-Methode legt die ID fest, die zum Korrelieren von SoH-Anforderungen und SoH-Antworten verwendet wird.

Syntax

HRESULT SetCorrelationId(
  [in] CorrelationId correlationId
);

Parameter

correlationId [ In]

Eine eindeutige CorrelationId-Struktur, die einen bestimmten SoH-Austausch identifiziert.

Rückgabewert

Es können auch andere COM-spezifische Fehlercodes zurückgegeben werden.

Rückgabecode Beschreibung
S _ OK
Vorgang erfolgreich.
E _ ACCESSDENIED
Berechtigungsfehler, Zugriff verweigert.
E _ OUTOFMEMORY
Systemressourcenlimit, konnte den Vorgang nicht ausführen.

Bemerkungen

Die Korrelations-ID wird vom NapAgent festgelegt und basiert auf der Verbindungs-ID.

Diese ID wird verwendet, um Anforderungen und Antworten zu korrelieren, d.h. sie beschreibt eindeutig einen SoH-Austausch und enthält immer die ID des letzten SoH-Satzes für das Verbindungsobjekt.

Wenn ein SoH-Response empfangen wird, stellt napAgent zunächst sicher, dass die IDs übereinstimmen. Andernfalls wird ein Fehler zurückgegeben, und der Erzwingende muss das Paket löschen. Weitere Informationen finden Sie unter INapEnforcementClientBinding::P rocessSoHResponse.

Requirements (Anforderungen)

Anforderung Wert
Unterstützte Mindestversion (Client)
Windows [Nur Vista-Desktop-Apps]
Unterstützte Mindestversion (Server)
Windows Nur Server [ 2008-Desktop-Apps]
Header
NapEnforcementClient.h
IDL
NapEnforcementClient.idl
DLL
Qagent.dll

Weitere Informationen

INapEnforcementClientConnection