Função CM_Get_Sibling_Ex (cfgmgr32.h)

  • Artigo

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

A função CM_Get_Sibling_Ex obtém um identificador de instância de dispositivo para o próximo nó irmão de um nó de dispositivo especificado, em uma árvore de dispositivo local ou de um computador remoto.

Sintaxe

CMAPI CONFIGRET CM_Get_Sibling_Ex(
  [out]          PDEVINST pdnDevInst,
  [in]           DEVINST  dnDevInst,
  [in]           ULONG    ulFlags,
  [in, optional] HMACHINE hMachine
);

Parâmetros

[out] pdnDevInst

Ponteiro fornecido pelo chamador para o identificador de instância do dispositivo para o nó irmão que essa função recupera. O identificador recuperado está associado ao identificador do computador especificado por hMachine.

[in] dnDevInst

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

[in] ulFlags

Não usado, deve ser 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, ele retornará um dos códigos de erro prefixados por CR_ definidos em Cfgmgr32.h.

Comentários

Para enumerar todos os filhos de um nó de dispositivo na árvore de dispositivos do computador local, primeiro chame CM_Get_Child_Ex para obter um identificador para o primeiro nó filho e, em seguida, chame CM_Get_Sibling_Ex para obter identificadores para o restante dos filhos.

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 Windows 8 e Windows Server 2012 e sistemas operacionais 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_Sibling