Función WsGetMissingMetadataDocumentAddress (webservices.h)

  • Artículo

Esta función devuelve la dirección de un documento que falta al que hace referencia el objeto de metadatos.

Cada documento que se agrega al objeto de metadatos puede contener referencias a otros documentos. Una vez que se haya agregado un documento de nuevo a los metadatos, la función se puede usar para buscar el siguiente documento que falta.

Nota Esta función producirá un error si el nombre de host de la dirección URL que falta no se puede comprobar como uno de los nombres de host esperados. Los nombres de host esperados son una unión de lo siguiente:
 

Sintaxis

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

Parámetros

[in] metadata

Este parámetro es un puntero a un objeto Metadata que debe tener el documento.

address

Si se ejecuta correctamente, este parámetro se rellena con un puntero a la dirección de un documento de metadatos que falta o NULL si no faltan documentos de metadatos.

La dirección URL de la dirección devuelta está completa.

Nota Los datos devueltos por esta función son válidos hasta que el objeto de metadatos se libera o restablece. Los datos no deben modificarse.
 

[in, optional] error

Este parámetro es un puntero WS_ERROR a donde se debe almacenar información adicional sobre el error si se produce un error en la función.

Valor devuelto

Esta función puede devolver uno de estos valores.

Código devuelto Descripción
E_INVALIDARG
 Uno o más argumentos no son válidos.
E_OUTOFMEMORY
 Se quedó sin memoria.
Otros errores
Esta función puede devolver otros errores no enumerados anteriormente.

Comentarios

Si esta función comprobará o no los nombres de host de las direcciones URL devueltas se pueden controlar mediante el valor del enumerador WS_METADATA_PROPERTY_VERIFY_HOST_NAMES .

El propósito de la comprobación del nombre de host es asegurarse de que una aplicación no usa la dirección sin saber que procede de un host del que está dispuesto a aceptar metadatos.

Requisitos

   
Cliente mínimo compatible Windows 7 [aplicaciones de escritorio | Aplicaciones para UWP]
Servidor mínimo compatible Windows Server 2008 R2 [aplicaciones de escritorio | Aplicaciones para UWP]
Plataforma de destino Windows
Encabezado webservices.h
Library WebServices.lib
Archivo DLL WebServices.dll