Metodo IMbnDeviceService::WriteData (mbnapi.h)
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.
Scrivere dati in una sessione dati del servizio dispositivi.
Sintassi
HRESULT WriteData(
[in] SAFEARRAY *deviceServiceData,
[out] ULONG *requestID
);
Parametri
[in] deviceServiceData
Matrice di byte passata al dispositivo da scrivere.
[out] requestID
ID richiesta univoco assegnato dal servizio Mobile Broadband per identificare questa richiesta.
Valore restituito
Il metodo può restituire uno dei valori seguenti.
| Codice restituito | Descrizione |
|---|---|
|
Metodo completato correttamente. |
|
Questo comando del servizio dispositivo non è consentito per chiamare i privilegi del processo. |
|
La lunghezza di deviceServiceData è maggiore di MaxDataSize supportata. |
|
La sessione del servizio dispositivo non è aperta. |
|
Errore durante l'esecuzione di questo metodo. |
Commenti
WriteData passa dati in blocco a un servizio dispositivo specifico del fornitore nel dispositivo. Il servizio Mobile Broadband inoltra la richiesta al dispositivo. deviceServiceData verrà copiato byte per byte nel buffer dei dati passato alla richiesta. Questo buffer di dati deve essere minore di maxDataSize byte.
La sessione dati deve essere aperta prima che l'applicazione possa chiamare WriteData. Il sistema operativo non fornisce garanzie sulla latenza o sulle prestazioni di WriteData.
Si tratta di un'operazione asincrona e WriteData restituirà immediatamente. Al termine dell'operazione, il servizio Mobile Broadband chiamerà il metodo OnWriteDataComplete dell'interfaccia IMbnDeviceServicesEvents .
Requisiti
| Piattaforma di destinazione | Windows |
| Intestazione | mbnapi.h |