Função SetupDiDeleteDeviceInterfaceRegKey (setupapi.h)

  • Artigo

A função SetupDiDeleteDeviceInterfaceRegKey exclui a subchave do Registro usada por aplicativos e drivers para armazenar informações específicas da interface.

Sintaxe

WINSETUPAPI BOOL SetupDiDeleteDeviceInterfaceRegKey(
  [in] HDEVINFO                  DeviceInfoSet,
  [in] PSP_DEVICE_INTERFACE_DATA DeviceInterfaceData,
       DWORD                     Reserved
);

Parâmetros

[in] DeviceInfoSet

Um ponteiro para um conjunto de informações do dispositivo que contém a interface para a qual excluir informações específicas da interface no registro. O conjunto de informações do dispositivo não deve conter elementos remotos.

[in] DeviceInterfaceData

Um ponteiro para uma estrutura SP_DEVICE_INTERFACE_DATA que especifica a interface do dispositivo em DeviceInfoSet. Esse ponteiro possivelmente é retornado por SetupDiCreateDeviceInterface ou SetupDiEnumDeviceInterfaces.

Reserved

Reservado. Deve ser zero.

Retornar valor

SetupDiDeleteDeviceInterfaceRegKey retornará TRUE se for bem-sucedido; caso contrário, ele retorna FALSE e o erro registrado pode ser recuperado com uma chamada para GetLastError.

Comentários

O chamador dessa função deve ser um membro do grupo Administradores.

SetupDiDeleteDeviceInterfaceRegKey exclui a subchave usada por drivers e aplicativos para armazenar informações sobre a instância da interface do dispositivo. Essa subchave foi criada por SetupDiCreateDeviceInterfaceRegKey ou pela chamada do driver para uma rotina de gerente de E/S associada. SetupDiDeleteDeviceInterfaceRegKey não afeta a chave do registro main para a instância da interface do dispositivo nem quaisquer outras subchaves que possam ter sido criadas.

O DeviceInfoSet deve conter apenas elementos no computador local.

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 setupapi.h (inclua Setupapi.h)
Biblioteca Setupapi.lib
DLL Setupapi.dll

Confira também

SetupDiCreateDeviceInterface

SetupDiCreateDeviceInterfaceRegKey