Metodo IMbnDeviceService::QueryCommand (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.
Invia un comando di controllo QUERY al servizio dispositivo di un dispositivo Mobile Broadband.
Sintassi
HRESULT QueryCommand(
[in] ULONG commandID,
[in] SAFEARRAY *deviceServiceData,
[out] ULONG *requestID
);
Parametri
[in] commandID
Identificatore del comando.
[in] deviceServiceData
Matrice di byte passata al dispositivo.
[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. |
|
Errore durante l'esecuzione di questo metodo. |
Commenti
QueryCommand esiste per implementare funzionalità del servizio dispositivi specifiche del fornitore che non sono altrimenti coperte nell'API Mobile Broadband. La sessione di comando in un servizio di dispositivo deve essere aperta prima che l'applicazione possa chiamare QueryCommand.
Il servizio Mobile Broadband emetterà una richiesta QUERY al dispositivo. deviceServiceData verrà copiato byte per byte nel buffer dei dati passato alla richiesta. Questo buffer di dati non deve essere maggiore di maxCommandSize byte.
Si tratta di un'operazione asincrona e QueryCommand restituirà immediatamente. Al termine dell'operazione, il servizio Mobile Broadband chiamerà il metodo OnQueryCommandComplete dell'interfaccia IMbnDeviceServicesEvents .
Requisiti
Requisito | Valore |
---|---|
Client minimo supportato | Windows 8 [app desktop | App UWP] |
Server minimo supportato | Nessuno supportato |
Piattaforma di destinazione | Windows |
Intestazione | mbnapi.h |