Fonction WsReadEndpointAddressExtension (webservices.h)

Article
08/27/2023

Lit une extension du WS_ENDPOINT_ADDRESS.

Syntaxe

HRESULT WsReadEndpointAddressExtension(
  [in]           WS_XML_READER                      *reader,
  [in]           WS_ENDPOINT_ADDRESS                *endpointAddress,
  [in]           WS_ENDPOINT_ADDRESS_EXTENSION_TYPE extensionType,
  [in]           WS_READ_OPTION                     readOption,
  [in]           WS_HEAP                            *heap,
                 void                               *value,
  [in]           ULONG                              valueSize,
  [in, optional] WS_ERROR                           *error
);

Paramètres

[in] reader

Lecteur XML à utiliser pour lire l’extension.

La fonction définit automatiquement l’entrée du lecteur si nécessaire pour lire les extensions.

[in] endpointAddress

Adresse de point de terminaison contenant les extensions.

[in] extensionType

Type d’extension à lire.

[in] readOption

Indique si la valeur est requise et comment allouer la valeur. Pour plus d’informations , consultez WS_READ_OPTION .

Ce paramètre doit avoir l’une des valeurs suivantes :

[in] heap

Tas à utiliser pour stocker la valeur qui est lue.

value

Adresse d’une mémoire tampon pour placer la valeur lue.

Si vous utilisez WS_READ_REQUIRED_VALUE pour le paramètre readOption, la mémoire tampon doit correspondre à la taille du type d’extension lu (qui varie d’WS_ENDPOINT_ADDRESS_EXTENSION_TYPE).

Si vous utilisez WS_READ_REQUIRED_POINTER ou WS_READ_OPTIONAL_POINTER, la mémoire tampon doit avoir la taille d’un pointeur.

[in] valueSize

Taille de la mémoire tampon allouée par l’appelant pour la valeur lue.

Cette taille doit correspondre à la taille de la mémoire tampon passée à l’aide du paramètre value.

[in, optional] error

Spécifie l’emplacement où les informations d’erreur supplémentaires doivent être stockées en cas d’échec de la fonction.

Valeur retournée

Cette fonction peut retourner l’une de ces valeurs.

Code de retour	Description
E_INVALIDARG	Le type d’extension n’était pas valide. La taille de la mémoire tampon fournie n’était pas correcte. Un paramètre obligatoire était NULL.
WS_E_INVALID_FORMAT	Les données d’entrée n’étaient pas au format attendu ou n’avaient pas la valeur attendue.
E_OUTOFMEMORY	Nous avons manqué de mémoire.
Autres erreurs	Cette fonction peut renvoyer d’autres erreurs non répertoriées ci-dessus.

Remarques

La valeur retournée est valide jusqu’à ce que le tas soit libéré ou réinitialisé.

Si le type d’extension demandé apparaît plusieurs fois dans la mémoire tampon des extensions, la première instance est retournée.

Configuration requise

Condition requise	Valeur
Client minimal pris en charge	Windows 7 [applications de bureau \| Applications UWP]
Serveur minimal pris en charge	Windows Server 2008 R2 [applications de bureau \| Applications UWP]
Plateforme cible	Windows
En-tête	webservices.h
Bibliothèque	WebServices.lib
DLL	WebServices.dll

Partager via