função CM_Set_DevNode_Problem_Ex (cfgmgr32.h)

  • Artigo

[Começando com Windows 8 e Windows Server 2012, essa função foi preterida. Em vez disso, use CM_Set_DevNode_Problem .]

A função CM_Set_DevNode_Problem_Ex define um código de problema para um dispositivo instalado em um computador local ou remoto.

Sintaxe

CMAPI CONFIGRET CM_Set_DevNode_Problem_Ex(
  [in]           DEVINST  dnDevInst,
  [in]           ULONG    ulProblem,
  [in]           ULONG    ulFlags,
  [in, optional] HMACHINE hMachine
);

Parâmetros

[in] dnDevInst

Identificador de instância de dispositivo fornecido pelo chamador associado ao identificador do computador fornecido pelo hMachine.

[in] ulProblem

Fornece um código de problema, que é zero ou um dos sinalizadores de CM_PROB_Xxx descritos em Gerenciador de Dispositivos Mensagens de Erro. Um valor zero indica que um código de problema não está definido para o dispositivo.

[in] ulFlags

Deve ser definido como zero.

[in, optional] hMachine

Identificador de computador fornecido pelo chamador ao qual o identificador de instância do dispositivo fornecido pelo chamador está associado.

Nota Não há suporte para o uso dessa função para acessar computadores remotos, começando com Windows 8 e Windows Server 2012, pois essa funcionalidade foi removida.
 

Retornar valor

Se a operação for bem-sucedida, a função retornará CR_SUCCESS. Caso contrário, a função retornará um dos códigos de erro prefixados por CR_ definidos em Cfgmgr32.h.

Comentários

Use essa função para definir um código de problema para um dispositivo instalado em um computador local ou remoto. Você também pode usar as seguintes funções para definir o código de problema de um dispositivo e obter o código de problema definido para o dispositivo:

  • CM_Get_DevNode_Status retorna o conjunto de códigos de problema para um dispositivo instalado em um computador local.

  • CM_Get_DevNode_Status_Ex retorna o conjunto de códigos de problema para um dispositivo instalado em um computador local ou remoto.

  • CM_Set_DevNode_Problem define um código de problema para um dispositivo instalado em um computador local.

Para obter informações sobre como usar identificadores de instância de dispositivo associados a um computador local ou remoto, consulte CM_Get_Child_Ex.

A funcionalidade para acessar computadores remotos foi removida em sistemas operacionais Windows 8 e Windows Server 2012 e posteriores, portanto, você não pode acessar computadores remotos durante a execução nessas versões do Windows.

Requisitos

Requisito Valor
Cliente mínimo com suporte Disponível no Microsoft Windows 2000 e versões posteriores do Windows.
Plataforma de Destino Área de Trabalho
Cabeçalho cfgmgr32.h (inclua Cfgmgr32.h)
Biblioteca Cfgmgr32.lib
DLL Cfgmgr32.dll

Confira também

CM_Get_Child_Ex

CM_Get_DevNode_Status

CM_Get_DevNode_Status_Ex

CM_Set_DevNode_Problem