Método IMbnServiceActivation::Activate (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.

Envie a solicitação de ativação de serviço para a rede.

Sintaxe

HRESULT Activate(
  [in]  SAFEARRAY *vendorSpecificData,
  [out] ULONG     *requestID
);

Parâmetros

[in] vendorSpecificData

Uma matriz de bytes específica do fornecedor passada em uma operação de ativação de serviço. Esses dados serão passados pelo serviço de Banda Larga Móvel em uma solicitação SET OID_WWAN_SERVICE_ACTIVATION OID para o driver de miniport.

[out] requestID

A ID da solicitação para esta operação.

Retornar valor

Esse método pode retornar um desses valores.

Código de retorno	Descrição
S_OK	O método foi concluído com sucesso.
HRESULT_FROM_WIN32(ERROR_SERVICE_NOT_ACTIVE)	O serviço de Banda Larga Móvel não está em execução neste sistema.
E_HANDLE	Interface inválida. Provavelmente, o dispositivo foi removido do sistema.
HRESULT_FROM_WIN32(ERROR_NOT_FOUND)	A interface é inválida. Provavelmente, o dispositivo de Banda Larga Móvel foi removido do sistema. Interface inválida. Provavelmente, o dispositivo foi removido do sistema.

Comentários

O método Activate pode ser usado por um aplicativo para ativar o serviço da rede celular. O formato dos dados passados nesta solicitação é específico do fornecedor.

O campo VendorSpecificBufferSize da solicitação OID seria definido como o tamanho dos dados no SAFEARRAY, vendorSpecificData. O conteúdo de vendorSpecificData será copiado byte por byte na solicitação OID para o driver.

Consulte o Modelo de Driver de Banda Larga Móvel para obter mais informações sobre operações de ativação de serviço.

Essa é uma operação assíncrona que retornará imediatamente. Se o método retornar sem erro, o serviço de Banda Larga Móvel chamará o método OnActivationComplete da interface IMbnServiceActivationEvents .

Requisitos

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

Confira também

IMbnServiceActivation