Metodo IMbnDeviceService::QueryCommand (mbnapi.h)

Articolo
02/28/2024

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

Condividi tramite