WsGetServiceHostProperty-Funktion (webservices.h)

Ruft eine angegebene Diensthosteigenschaft ab. Die abzurufende Eigenschaft wird durch einen WS_SERVICE_PROPERTY_ID-Eingabeparameter identifiziert.

Syntax

HRESULT WsGetServiceHostProperty(
  [in]           WS_SERVICE_HOST              *serviceHost,
  [in]           const WS_SERVICE_PROPERTY_ID id,
                 void                         *value,
  [in]           ULONG                        valueSize,
  [in, optional] WS_ERROR                     *error
);

Parameter

[in] serviceHost

Ein Zeiger auf das WS_SERVICE_HOST-Objekt, das die abzurufende Eigenschaft enthält.

[in] id

Dies ist ein WS_SERVICE_PROPERTY_ID Enumeratorwert, der die abzurufende Eigenschaft identifiziert.

value

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

[in] valueSize

Die Puffergröße mit Bytelänge, die vom Aufrufer zum Speichern des abgerufenen Eigenschaftswerts zugewiesen wird.

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

Anforderungen

Unterstützte Mindestversion (Client)	Windows 7 [nur Desktop-Apps]
Unterstützte Mindestversion (Server)	Windows Server 2008 R2 [nur Desktop-Apps]
Zielplattform	Windows
Kopfzeile	webservices.h
Bibliothek	WebServices.lib
DLL	WebServices.dll