Freigeben über

WS_IS_DEFAULT_VALUE_CALLBACK Rückruffunktion (webservices.h)

  • Artikel

Bestimmt, ob ein Wert der Standardwert ist. Dieser Rückruf wird verwendet, bevor ein Wert, der von einer WS_CUSTOM_TYPE behandelt wird, serialisiert wird. Die Unterstützung für Standardwerte wird aktiviert, indem angegeben wird, wann im WS_FIELD_DESCRIPTIONWS_FIELD_OPTIONAL.

Syntax

WS_IS_DEFAULT_VALUE_CALLBACK WsIsDefaultValueCallback;

HRESULT WsIsDefaultValueCallback(
  [in]           const void *descriptionData,
                 const void *value,
                 const void *defaultValue,
  [in]           ULONG valueSize,
  [out]          BOOL *isDefault,
  [in, optional] WS_ERROR *error
)
{...}

Parameter

[in] descriptionData

Dies ist der Wert des Felds descriptionData aus WS_CUSTOM_TYPE_DESCRIPTION. Der Rückruf kann dies verwenden, um auf alle zusätzlichen Informationen zum Typ zuzugreifen.

value

Ein Zeiger auf den Wert, der serialisiert wird.

defaultValue

Ein Zeiger auf den Standardwert. Wenn für das Feld kein Standardwert angegeben wurde, lautet dieser Parameter NULL.

Wenn der Parameter nicht NULL ist, sollte der Rückruf die beiden Werte Feld für Feld gemäß dem benutzerdefinierten Typ vergleichen. Wenn die Felder übereinstimmen, sollte der parameter isDefault auf TRUE festgelegt werden.

Wenn der Parameter NULL ist, sollte der Rückruf die Felder des Werts mit null vergleichen. Wenn die Felder übereinstimmen, sollte der parameter isDefault auf TRUE festgelegt werden.

[in] valueSize

Die Größe des Werts, der serialisiert wird, in Bytes.

[out] isDefault

Gibt an, ob der Wert der Standardwert ist.

[in, optional] error

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

Rückgabewert

Diese Rückruffunktion gibt keinen Wert zurück.

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