Compartilhar via

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

  • Artigo

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 QUERY para o serviço de dispositivo de um dispositivo de Banda Larga Móvel.

Sintaxe

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

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

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

Essa é uma operação assíncrona e QueryCommand retornará imediatamente. Após a conclusão da operação, o serviço de Banda Larga Móvel chamará o método OnQueryCommandComplete 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