WsMatchPolicyAlternative-Funktion (webservices.h)
Überprüft, ob eine Richtlinienalternative mit der angegebenen Richtlinieneinschränkung kompatibel ist. Wenn die Alternative kompatibel ist, werden die Einschränkungsstrukturen mit Richtlinieninformationen aufgefüllt.
Syntax
HRESULT WsMatchPolicyAlternative(
[in] WS_POLICY *policy,
[in] ULONG alternativeIndex,
[in] WS_POLICY_CONSTRAINTS *policyConstraints,
[in] BOOL matchRequired,
[in] WS_HEAP *heap,
[in, optional] WS_ERROR *error
);
Parameter
[in] policy
Ein Zeiger auf ein WS_POLICY-Objekt , das die Alternative enthält.
[in] alternativeIndex
Gibt den nullbasierten Index an, der die Alternative identifiziert, die innerhalb des Richtlinienobjekts verwendet werden soll. Die Anzahl der im Richtlinienobjekt vorhandenen Alternativen kann mithilfe von WsGetPolicyAlternativeCount abgerufen werden.
[in] policyConstraints
Ein Zeiger auf die Einschränkungen, die Richtlinien angeben, die zusammen mit den Feldern übereinstimmen, die aufgefüllt werden sollen, wenn die Funktion NOERROR zurückgibt.
Weitere Informationen finden Sie unter WS_POLICY_CONSTRAINTS .
[in] matchRequired
Gibt an, ob eine Übereinstimmung erforderlich ist.
Wenn der Wert dieses Parameters TRUE ist, ist eine Übereinstimmung erforderlich, und wenn die Richtlinie nicht übereinstimmt, gibt die Funktion einen Fehler zurück.
[in] heap
Ein Zeiger auf ein Heap-Objekt , das zum Speichern aller Daten verwendet wird, die eine Zuordnung über die angegebene Einschränkung hinaus erfordern.
[in, optional] error
Ein Zeiger auf ein WS_ERROR-Objekt , in dem zusätzliche Informationen zum Fehler gespeichert werden sollen, wenn die Funktion fehlschlägt.
Rückgabewert
Diese Funktion kann einen dieser Werte zurückgeben.
Rückgabecode | Beschreibung |
---|---|
|
Mindestens ein Argument ist ungültig. |
|
Die Richtlinienalternative erfüllt nicht die angegebenen Einschränkungen, und matchRequired wurde auf TRUE festgelegt.
Die Richtlinie oder andere Metadaten waren in einem ungültigen Format. |
|
Die Richtlinienalternative erfüllt nicht die angegebenen Einschränkungen, und matchRequired wurde auf FALSE festgelegt. |
|
Die Richtlinienalternative erfüllt die spezifischen Einschränkungen. Die out-Felder der Einschränkungsstrukturen wurden mit Werten aus der Richtlinie gefüllt. |
Hinweise
Jeder dieser Datentypen enthält ein Strukturfeld mit dem Namen "out".
- WS_CHANNEL_PROPERTY_CONSTRAINT
- WS_SECURITY_PROPERTY_CONSTRAINT
- WS_SECURITY_BINDING_PROPERTY_CONSTRAINT
- WS_SSL_TRANSPORT_SECURITY_BINDING_CONSTRAINT
Das Richtlinienobjekt kann die Verarbeitung verzögern, bis diese Funktion aufgerufen wird. Wenn die Verarbeitung fehlschlägt, wird das Richtlinienobjekt auf WS_POLICY_STATE_FAULTED festgelegt.
Anforderungen
Anforderung | Wert |
---|---|
Unterstützte Mindestversion (Client) | Windows 7 [Desktop-Apps | UWP-Apps] |
Unterstützte Mindestversion (Server) | Windows Server 2008 R2 [Desktop-Apps | UWP-Apps] |
Zielplattform | Windows |
Kopfzeile | webservices.h |
Bibliothek | WebServices.lib |
DLL | WebServices.dll |