Expand Minimize

WsGetMissingMetadataDocumentAddress function

This function returns the address of a missing document that is referenced by the metadata object.

Each document that is added to the metadata object may contain references to other documents. After a document has been added back to the Metadata the function can be used to find the next missing document.

Note  This function will fail if the host name of the URL of the missing address being returned cannot be verified as being one of the host names expected. The expected host names are a union of the following:

Syntax


HRESULT WINAPI  WsGetMissingMetadataDocumentAddress(
  _In_      WS_METADATA* metadata,
  WS_ENDPOINT_ADDRESS** address,
  _In_opt_  WS_ERROR* error
);

Parameters

metadata [in]

This parameter is a pointer to a Metadata object that should have the document.

address

On success this parameter is populated with either a pointer to the address of a missing metadata document, or NULL if there are no missing metadata documents. The returned address URL is fully qualified.

Note   The data returned by this function is valid until the metadata object is freed or reset. The data should not be modified.

error [in, optional]

This parameter is a WS_ERROR pointer to where additional information about the error should be stored if the function fails.

Return value

This function can return one of these values.

Return codeDescription
E_INVALIDARG

One or more arguments are invalid.

E_OUTOFMEMORY

Ran out of memory.

Other Errors

This function may return other errors not listed above.

 

Remarks

Whether or not this function will verify host names of URLs returned can be controlled using the WS_METADATA_PROPERTY_VERIFY_HOST_NAMES enumerator value.

The purpose of the host name verification is to ensure that an application does not use the address without knowing that it is from a host that it is willing to accept metadata from.

Requirements

Minimum supported client

Windows 7 [desktop apps | Windows Store apps]

Minimum supported server

Windows Server 2008 R2 [desktop apps | Windows Store apps]

Header

WebServices.h

Library

WebServices.lib

DLL

WebServices.dll

 

 

Community Additions

ADD
Show:
© 2015 Microsoft