Condividi tramite


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
S_OK
Metodo completato correttamente.
E_ACCESSDENIED
Questo comando del servizio dispositivo non è consentito per chiamare i privilegi del processo.
Altri
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

Vedi anche

IMbnDeviceService