Metodo IMbnDeviceService::SetCommand (mbnapi.h)

Articolo
08/24/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.

Invia un comando di controllo SET al servizio dispositivo di un dispositivo Mobile Broadband.

Sintassi

HRESULT SetCommand(
  [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

SetCommand esiste per implementare funzionalità del servizio dispositivi specifiche del fornitore che non sono altrimenti coperte nell'API Mobile Broadband. Prima che l'applicazione possa chiamare SetCommand, è necessario aprire una sessione di comando in un servizio di dispositivo.

Il servizio Mobile Broadband emetterà una richiesta SET al dispositivo. deviceServiceData verrà copiato byte per byte nel buffer dei dati passato alla richiesta. Questo buffer di dati deve essere minore di maxCommandSize byte.

Si tratta di un'operazione asincrona e SetCommand restituirà immediatamente. Al termine dell'operazione, il servizio Mobile Broadband chiamerà il metodo OnSetCommandComplete 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