WsGetServiceHostProperty-Funktion (webservices.h)

  • Artikel

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