Metodo IMbnConnectionProfileManager::CreateConnectionProfile (mbnapi.h)

Articolo
03/09/2023

Importante

A partire da Windows 10 versione 1803, le API Win32 descritte in questa sezione vengono sostituite dalle API Windows Runtime nello spazio dei nomi Windows.Networking.Connectivity.

Crea un nuovo profilo di connessione per il dispositivo.

Sintassi

HRESULT CreateConnectionProfile(
  [in] LPCWSTR xmlProfile
);

Parametri

[in] xmlProfile

Stringa con terminazione Null che contiene i dati del profilo in formato XML conforme al riferimento allo schema del profilo Mobile Broadband.

Valore restituito

Questo metodo può restituire uno di questi valori.

Codice restituito	Descrizione
S_OK	Metodo completato correttamente.
HRESULT_FROM_WIN32(ERROR_ALREADY_EXISTS)	Esiste già un profilo con il nome specificato.
E_MBN_INVALID_PROFILE	Il profilo non è conforme allo schema del profilo Mobile Broadband.
HRESULT_FROM_WIN32(ERROR_FILE_NOT_FOUND)	Il percorso del file icona passato nel profilo non è valido o non è accessibile.
E_MBN_DEFAULT_PROFILE_EXIST	L'applicazione chiamante ha specificato il flag di profilo predefinito nei dati XML, ma il profilo predefinito esiste già per il dispositivo Mobile Broadband.

Commenti

Si tratta di un'operazione sincrona. Se questa chiamata di funzione ha esito positivo, verrà creato un nuovo profilo e il servizio Mobile Broadband chiamerà il metodo OnConnectionProfileArrival dell'interfaccia IMbnConnectionProfileManagerEvents .

Se il percorso del file icona viene specificato nei dati del profilo, il servizio Mobile Broadband copia il file icona dal percorso specificato nel proprio archivio. Una query successiva sull'oggetto IMbnConnectionProfile per il percorso del file icona restituirà il percorso del file in cui il servizio Mobile Broadband archivia il file icona. Ogni volta che un profilo viene eliminato dal sistema, anche il relativo file icona viene eliminato dal sistema. Il file icona deve essere in formato file bmp con dimensioni di 32x32 pixel.

Requisiti


Client minimo supportato	Windows 7 [solo app desktop]
Server minimo supportato	Nessuno supportato
Piattaforma di destinazione	Windows
Intestazione	mbnapi.h

Vedi anche

IMbnConnectionProfileManager

Condividi tramite