Fonction WsGetMetadataEndpoints (webservices.h)

Article
03/03/2024

Retourne les « points de terminaison » définis dans les documents de l’objet de métadonnées. L’appel de cette fonction avec WS_METADATA_STATEdéfini sur WS_METADATA_STATE_CREATED entraîne la résolution de toutes les références dans les documents de métadonnées par l’objet de métadonnées. Toute validation de document supplémentaire sera également effectuée. Si ce processus réussit, l’objet de métadonnées est défini sur WS_METADATA_STATE_RESOLVED et les ajouts de documents ultérieurs à l’objet de métadonnées ne sont pas autorisés. En cas d’erreur, l’objet de métadonnées est défini sur WS_METADATA_STATE_FAULTED.

Note Les données retournées par cette fonction sont valides jusqu’à ce que l’objet de métadonnées soit libéré ou réinitialisé. Les données retournées par cette fonction ne doivent pas être modifiées.

Syntaxe

HRESULT WsGetMetadataEndpoints(
  [in]           WS_METADATA           *metadata,
  [out]          WS_METADATA_ENDPOINTS *endpoints,
  [in, optional] WS_ERROR              *error
);

Paramètres

[in] metadata

Pointeur vers un objet Metadata contenant les points de terminaison souhaités. Ce paramètre doit être un objet WS_METADATA valide.

[out] endpoints

En cas de réussite, ce paramètre de pointeur est rempli avec des informations sur les points de terminaison qui ont été définis dans l’objet de métadonnées.

[in, optional] error

Pointeur vers un objet WS_ERROR où des informations supplémentaires sur l’erreur 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	L’ID de propriété n’était pas pris en charge pour cet objet ou la mémoire tampon spécifiée n’était pas assez grande pour la valeur.
E_OUTOFMEMORY	Ressources de mémoire insuffisantes.
Autres erreurs	Cette fonction peut renvoyer d’autres erreurs non répertoriées ci-dessus.

Remarques

Cette propriété peut être utilisée à l’état WS_METADATA_STATE_CREATED ou WS_METADATA_STATE_RESOLVED .

Cette fonction échoue s’il manque des documents de métadonnées. Utilisez WsGetMissingMetadataDocumentAddress pour déterminer l’adresse des documents manquants.

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