PHValidateProvisionXML (Windows Embedded CE 6.0)

1/6/2010

This function performs run time validation of the specified XML provisioning data.

Syntax

HRESULT PHValidateProvisionXML(
const WCHAR*  pInputBuffer
);

Parameters

  • pInputBuffer
    [in] Pointer to the input XML buffer containing the provision data. It can also be used to specify a XML file name.

Return Value

Returns the standard HRESULT values. S_OK indicates success and valid input XML. The following table shows additional error codes that may be returned.

Value Description

PROVISION_E_MULTIPLE_SETTINGS

There are multiple operations on the same setting(s) in the XML file

PROVISION_E_INVALID_SETTING

One of the settings is invalid

Remarks

Note

This documentation applies to functionality implemented in sample code for PhCommon. For more information, see PhCommon Reference.

The pInputBuffer parameter can contain explicit provisioning information (a string or pointer to a string containing the provisioning data), or it can contain the pathname of a provisioning XML file. For example:

Examples:

1. String containing explicit provisioning information.

PHValidateProvisionXML("<voip-provision><set name='VoicemailNumber' value='5555551212' /></voip-provision>");

2. Pathname of provisioning XML file.

PHValidateProvisionXML("file:\\\Windows\provisioning.xml");

Requirements

Header phoneapi.hpp
Library PhCommon.dll
Windows Embedded CE Windows Embedded CE 6.0

See Also

Reference

PhCommon Provisioning APIs
PhCommon Reference

Concepts

IP Phone Suite Provisioning
IP Phone Suite Provisioning Examples