WsGetSecurityContextProperty-Funktion (webservices.h)

Artikel
03/03/2024

Ruft eine Eigenschaft des angegebenen Sicherheitskontexts ab.

Syntax

HRESULT WsGetSecurityContextProperty(
  [in]           WS_SECURITY_CONTEXT             *securityContext,
  [in]           WS_SECURITY_CONTEXT_PROPERTY_ID id,
                 void                            *value,
  [in]           ULONG                           valueSize,
  [in, optional] WS_ERROR                        *error
);

Parameter

[in] securityContext

Der Sicherheitskontext, der nach seiner Eigenschaft abgefragt wird.

[in] id

Die ID der Eigenschaft (eine der WS_SECURITY_CONTEXT_PROPERTY_ID).

value

Die Adresse zum Platzieren des abgerufenen Werts. Der Zeiger muss über eine Ausrichtung verfügen, die mit dem Typ der Eigenschaft kompatibel ist.

[in] valueSize

Die Größe des Puffers, den der Aufrufer für den abgerufenen Wert zugewiesen hat.

[in, optional] error

Gibt an, wo zusätzliche Fehlerinformationen gespeichert werden sollen, wenn die Funktion fehlschlägt.

Rückgabewert

Diese Funktion kann einen dieser Werte zurückgeben.

Rückgabecode	Beschreibung
E_INVALIDARG	Die Eigenschafts-ID wurde für dieses Objekt nicht unterstützt, oder der angegebene Puffer war nicht groß genug für den Wert.
E_OUTOFMEMORY	Der Arbeitsspeicher ist nicht mehr vorhanden.
Andere Fehler	Diese Funktion gibt möglicherweise andere Fehler zurück, die oben nicht aufgeführt sind.

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