Device.ProvisionDevice - метод

Статья
11/05/2008

Обновлен: Ноябрь 2007

Контролирует использование устройства посредством вызова функции DMProcessConfigXML и передачи заданной строки XML.

Пространство имен: Microsoft.SmartDevice.Connectivity
Сборка: Microsoft.SmartDevice.Connectivity (в Microsoft.SmartDevice.Connectivity.dll)

Синтаксис

'Декларация
Public Function ProvisionDevice ( _
    xml As String, _
    action As Device..::.ConfigActions _
) As String
'Применение
Dim instance As Device
Dim xml As String
Dim action As Device..::.ConfigActions
Dim returnValue As String

returnValue = instance.ProvisionDevice(xml, _
    action)

public string ProvisionDevice(
    string xml,
    Device..::.ConfigActions action
)

public:
String^ ProvisionDevice(
    String^ xml, 
    Device..::.ConfigActions action
)

public function ProvisionDevice(
    xml : String, 
    action : Device..::.ConfigActions
) : String

Параметры

xml
Тип: System.String
XML для контролирования использования.

action
Тип: Microsoft.SmartDevice.Connectivity.Device.ConfigActions
Перечисление Device.ConfigActions указывает, должен ли метод считывать XML с устройства или применять XML для устройства.

Возвращаемое значение

Тип: System.String
Возвращаемое значение — это XML-файл конфигурации, считанный со смарт-устройства.
Формат соответствует формату определения типов документов (DTD) Microsoft MSPROV. Дополнительную информацию см. в разделах DTD-формат MSPROV и Примеры контролирования использования XML-файла.

Исключения

Исключение	Условие
DeviceNotConnectedException	Устройство не подключено.
SmartDeviceException	COM-исключение, которое вызывается базовыми COM-компонентами.
ArgumentNullException	Аргумент XML имеет значение NULL.
ArgumentException	Аргумент XML имеет недопустимое значение.

Заметки

Устройство должно быть подключено.

Формат параметра xml должен соответствовать формату определения типов документов (DTD) Microsoft MSPROV. Дополнительную информацию см. в разделах DTD-формат MSPROV и Примеры контролирования использования XML-файла.

Примеры

' Query Device for current security policies 
Dim readxml As String = "<wap-provisioningdoc>" & _
"<characteristic type=""SecurityPolicy"">" & _
"<parm-query name=""4123""/>" & _
"<parm-query name=""4122""/>" & _
"<parm-query name=""4101""/>" & _
"<parm-query name=""4102""/>" & _
"<parm-query name=""4097""/>" & _
"</characteristic>" & _
"</wap-provisioningdoc>"

Console.WriteLine(device.ProvisionDevice(readxml, _
                                         device.ConfigActions.ProcessInput))

' Deploy two-tier prompt security configuration to device and see changes
Dim provisionxml As String = "<wap-provisioningdoc>" & _
"<characteristic type=""SecurityPolicy"">" & _
"<parm name=""4123"" value=""0"" />" & _
"<parm name=""4122"" value=""0"" />" & _
"<parm name=""4101"" value=""16"" />" & _
"<parm name=""4102"" value=""1"" />" & _
"<parm name=""4097"" value=""2"" />" & _
"</characteristic>" & _
"</wap-provisioningdoc>"

Console.WriteLine(device.ProvisionDevice(provisionxml, _
                                         device.ConfigActions.ProcessInput))

' Read metadata about the policies
Console.WriteLine(device.ProvisionDevice(readxml, _
                                         device.ConfigActions.ReadMetadata))

                // Query Device for current security policies 
                string readxml = @"
<wap-provisioningdoc>
    <characteristic type=""SecurityPolicy"">
        <parm-query name=""4123""/>
        <parm-query name=""4122""/>
        <parm-query name=""4101""/>
        <parm-query name=""4102""/>
        <parm-query name=""4097""/>
    </characteristic>
</wap-provisioningdoc>";
                Console.WriteLine(device.ProvisionDevice(readxml, 
                    Device.ConfigActions.ProcessInput));

                // Deploy two-tier prompt security configuration to device and see changes
                string provisionxml = @"
<wap-provisioningdoc>
    <characteristic type=""SecurityPolicy"">
        <parm name=""4123"" value=""0"" />
        <parm name=""4122"" value=""0"" />
        <parm name=""4101"" value=""16"" />
        <parm name=""4102"" value=""1"" />
        <parm name=""4097"" value=""2"" />
    </characteristic>
</wap-provisioningdoc>";
                Console.WriteLine(device.ProvisionDevice(provisionxml, 
                    Device.ConfigActions.ProcessInput));

                // Read metadata about the policies
                Console.WriteLine(device.ProvisionDevice(readxml, 
                    Device.ConfigActions.ReadMetadata));

Разрешения

Полное доверие для непосредственно вызывающего метода. Этот член не может быть использован частично доверенным кодом. Дополнительные сведения см. в разделе Использование библиотек из не вполне надежного кода.