WsGetPolicyProperty-Funktion (webservices.h)

  • Artikel

Ruft eine Eigenschaft eines Richtlinienobjekts ab.

Syntax

HRESULT WsGetPolicyProperty(
  [in]           WS_POLICY             *policy,
  [in]           WS_POLICY_PROPERTY_ID id,
                 void                  *value,
  [in]           ULONG                 valueSize,
  [in, optional] WS_ERROR              *error
);

Parameter

[in] policy

Ein Zeiger auf das WS_POLICY-Objekt , von dem die -Eigenschaft abgerufen werden soll.

[in] id

Ein Bezeichner der abzurufenden Richtlinieneigenschaft.

value

Ein Zeiger auf die Adresse zum Speichern des abgerufenen Eigenschaftswerts. Der Zeiger muss über eine Ausrichtung verfügen, die mit dem Typ der Eigenschaft kompatibel ist.

[in] valueSize

Die Anzahl der Bytes, die der Aufrufer zum Speichern der abgerufenen Eigenschaft zugewiesen hat.

[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
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.

Hinweise

Die von dieser Funktion zurückgegebenen Daten sind gut, bis das Metadatenobjekt freigegeben oder zurückgesetzt wird.

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