Freigeben über


INapEnforcementClientBinding::GetSoHRequest-Methode

Hinweis

Die Netzwerkzugriffsschutzplattform ist ab Windows 10

Die INapEnforcementClientBinding::GetSoHRequest-Methode wird vom Erzwingungsclient verwendet, um eine SoH-Anforderung für eine bestimmte Verbindung abzurufen.

Syntax

HRESULT GetSoHRequest(
  [in]  INapEnforcementClientConnection *connection,
  [out] BOOL                            *retriggerHint
);

Parameter

Verbindung [in]

Ein COM-Zeiger auf eine INapEnforcementClientConnection-Schnittstelle . Der NapAgent enthält keine Verweise auf das Objekt, das dieser Schnittstelle zugeordnet ist, nachdem die Methode abgeschlossen ist.

retriggerHint [out]

Ein Zeiger auf eine BOOL , der angibt, ob die Verbindung erneut ausgelöst werden soll. Es ist TRUE , wenn sich die SoHRequest seit dem letzten Aufruf dieser Funktion geändert hat oder wenn ProbationTime abgelaufen ist. Andernfalls wird FALSE zurückgegeben.

Rückgabewert

Andere COM-spezifische Fehlercodes können ebenfalls zurückgegeben werden.

Rückgabecode BESCHREIBUNG
S_OK
Der Vorgang ist erfolgreich.
E_ACCESSDENIED
Berechtigungsfehler, Zugriff verweigert.
E_OUTOFMEMORY
Das Systemressourcenlimit konnte den Vorgang nicht ausführen.
NAP_E_NOT_INITIALIZED
Der Enforcer wurde noch nicht initialisiert.

Bemerkungen

Der NapAgent legt die SoHRequest für das Verbindungsobjekt fest.

Wenn eine SoHRequest für diese Verbindung aussteht, wird sie verworfen, und die SHAs werden über verwaiste SoHRequests benachrichtigt.

Der Erzwingungsclient muss die INapEnforcementClientBinding::Initialize-Methode aufrufen, bevor diese oder eine andere Methode der INapEnforcementClientBinding-Schnittstelle aufgerufen wird .

Anforderungen

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

Weitere Informationen

INapEnforcementClientBinding