Programmatically Customizing a Device
.gif "A checkmark indicates that the information in this topic is relevant for this platform, and that any API listed is also supported on this platform.")
.gif "A hyphen indicates that the information in this topic is not relevant for this platform, or that the platform does not support the API that is listed.")
9/8/2008
Você pode alteração uma configuração dispositivo such as um alarme ou a atual sistema de rede status, usando o modelo Configuration Service Provider (CSP) a alteração ou "configurar" o dispositivo.
Para tornar tal uma alteração, você deve primeiro criar uma documento XML que contém uma descrição das configurações para ser ajustado. Cada alteração deve incluir o nome CSP, o atributo (também conhecido como a "característica") e o valor ("Parm"). Várias alterações podem estar contidas em um documento XML.
Observação CPSs são controlados por um modelo de segurança, e, portanto, a lista exata do disponível recursos irá variar em um por-base dispositivo, como decidir por fabricantes dispositivo e operadores móveis.
O XML documento configuração, em seguida, é usado pelo Configuration Manager para tornar a change(s). Há várias maneiras nos quais o Configuration Manager podem ser chamados, incluindo criando um arquivo CAB e usando RAPI, mas a maioria dos desenvolvedores irá chamar a função DMProcessConfigXML diretamente, pois isso permite que alterações para ser executada no executar-tempo em um aplicativo.
No seguinte exemplo, um documento XML é construído que adicionar programaticamente será um novo site W3 (World Wide Web) para lista do Windows Mobile Explorer a de favoritos.
// WAP provisioning XML to add a new browser favorite.
LPCWSTR g_wszFavoriteXml =
L"<wap-provisioningdoc>"
L"<characteristic type=\"BrowserFavorite\">"
L"<characteristic type=\"Baldwin Museum of Science\">"
L"<parm name=\"URL\" value=\"http://www.baldwinmuseumofscience.com\"/>"
L"</characteristic>"
L"</characteristic>"
L"</wap-provisioningdoc>";
// Use configuration XML to add a new browser favorite to the device.
HRESULT AddFavorite()
{
HRESULT hr = E_FAIL;
LPWSTR wszOutput = NULL;
// Process the XML.
hr = DMProcessConfigXML(g_wszFavoriteXml, CFGFLAG_PROCESS, &wszOutput);
// The caller must delete the XML returned from DMProcessConfigXML.
delete [] wszOutput;
return hr;
}
Este exemplo XML é escrito usando padrão OMA Client Provisioning versão 1.0 e deve trabalho no atual Windows Mobile 6 Dispositivos (modelo de segurança permitindo). Para obter informações sobre a formatação de outras versões, consulte OMA Client Provisioning Files.
Ao construir o documento XML, verifique se o nó pai está definida para o formato correto (< WAP-provisioningdoc > Neste exemplo), com o atributo e parâmetro contidos dentro
LPCWSTR g_wszFavoriteXml =
L"<wap-provisioningdoc>"
// Your provisioning XML goes here.
L"</wap-provisioningdoc>";
A lista de atributos que podem ser alterados e o associado XML, podem ser encontradas na seção Configuration Service Provider Reference for Windows Mobile Powered Devices.
Para implementar alterações configuração de código gerenciado, você precisará criar um wrapper para a função nativo DMProcessConfigXML. Para obter mais informações, consulte Managed/Native Code Interoperability.
Tópicos relacionados
See Also
Concepts
Accessing low-level Device Information