Método IMbnDeviceService::SetCommand (mbnapi.h)

Importante

A partir de Windows 10, versão 1803, as APIs do Win32 descritas nesta seção são substituídas pelas APIs Windows Runtime no namespace Windows.Networking.Connectivity.

Envia um comando de controle SET para o serviço de dispositivo de um dispositivo de Banda Larga Móvel.

Sintaxe

HRESULT SetCommand(
  [in]  ULONG     commandID,
  [in]  SAFEARRAY *deviceServiceData,
  [out] ULONG     *requestID
);

Parâmetros

[in] commandID

Um identificador para o comando .

[in] deviceServiceData

Uma matriz de bytes que é passada para o dispositivo.

[out] requestID

Uma ID de solicitação exclusiva atribuída pelo serviço de Banda Larga Móvel para identificar essa solicitação.

Retornar valor

O método pode retornar um dos valores a seguir.

Código de retorno	Descrição
S_OK	O método foi concluído com sucesso.
E_ACCESSDENIED	Este comando de serviço de dispositivo não é permitido para chamar privilégios de processo.
Outros	Um erro foi encontrado ao executar esse método.

Comentários

SetCommand existe para implementar a funcionalidade de serviço de dispositivo específica do fornecedor, que não é abordada de outra forma na API de Banda Larga Móvel. Uma sessão de comando em um serviço de dispositivo deve ser aberta antes que o aplicativo possa chamar SetCommand.

O serviço de Banda Larga Móvel emitirá uma solicitação SET para o dispositivo. deviceServiceData será copiado byte por byte no buffer de dados passado para a solicitação. Esse buffer de dados deve ser menor que MaxCommandSize bytes.

Essa é uma operação assíncrona e SetCommand retornará imediatamente. Após a conclusão da operação, o serviço de Banda Larga Móvel chamará o método OnSetCommandComplete da interface IMbnDeviceServicesEvents .

Requisitos

Requisito	Valor
Cliente mínimo com suporte	Windows 8 [aplicativos da área de trabalho | Aplicativos UWP]
Servidor mínimo com suporte	Nenhum compatível
Plataforma de Destino	Windows
Cabeçalho	mbnapi.h

Confira também

IMbnDeviceService