WsGetMissingMetadataDocumentAddress, fonction (webservices.h)

Article
08/27/2023

Cette fonction retourne l’adresse d’un document manquant référencé par l’objet de métadonnées.

Chaque document ajouté à l’objet de métadonnées peut contenir des références à d’autres documents. Une fois qu’un document a été ajouté de nouveau aux métadonnées, la fonction peut être utilisée pour rechercher le document manquant suivant.

Note Cette fonction échoue si le nom d’hôte de l’URL de l’adresse manquante retournée ne peut pas être vérifié comme étant l’un des noms d’hôte attendus. Les noms d’hôtes attendus sont une union des éléments suivants :

Nom d’hôte de toute URL précédemment passée à WsReadMetadata.
Liste des noms d’hôtes spécifiés à l’aide de la propriété WS_METADATA_PROPERTY_HOST_NAMES .

Syntaxe

HRESULT WsGetMissingMetadataDocumentAddress(
  [in]           WS_METADATA         *metadata,
                 WS_ENDPOINT_ADDRESS **address,
  [in, optional] WS_ERROR            *error
);

Paramètres

[in] metadata

Ce paramètre est un pointeur vers un objet Metadata qui doit contenir le document.

address

En cas de réussite, ce paramètre est rempli avec un pointeur vers l’adresse d’un document de métadonnées manquant ou NULL s’il n’y a pas de documents de métadonnées manquants.

L’URL d’adresse retournée est complète.

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 ne doivent pas être modifiées.

[in, optional] error

Ce paramètre est un pointeur WS_ERROR vers l’emplacement 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	Un ou plusieurs arguments ne sont pas valides.
E_OUTOFMEMORY	Nous avons manqué de mémoire.
Autres erreurs	Cette fonction peut renvoyer d’autres erreurs non répertoriées ci-dessus.

Remarques

Vous pouvez contrôler si cette fonction vérifie ou non les noms d’hôte des URL retournées à l’aide de la valeur d’énumérateur WS_METADATA_PROPERTY_VERIFY_HOST_NAMES .

L’objectif de la vérification du nom d’hôte est de s’assurer qu’une application n’utilise pas l’adresse sans savoir qu’elle provient d’un hôte à partir duquel elle est prête à accepter des métadonnées.

Configuration requise


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