Método IFunctionDiscovery::RemoveInstance (functiondiscoveryapi.h)

[A Descoberta de Funções está disponível para uso nos sistemas operacionais especificados na seção Requisitos. Ele pode estar alterado ou indisponível em versões subsequentes.]

Remove a instância de função especificada, com base na categoria e na subcategoria.

Sintaxe

HRESULT RemoveInstance(
  [in] SystemVisibilityFlags enumSystemVisibility,
  [in] const WCHAR           *pszCategory,
  [in] const WCHAR           *pszSubCategory,
  [in] const WCHAR           *pszCategoryIdentity
);

Parâmetros

[in] enumSystemVisibility

Um valor SystemVisibilityFlags que especifica se a instância de função é removida em todo o sistema ou apenas para o usuário atual.

[in] pszCategory

A categoria da instância de função. Consulte Definições de categoria.

[in] pszSubCategory

A subcategoria da instância de função a ser removida. Consulte Definições de subcategoria. Este parâmetro pode ser NULL.

[in] pszCategoryIdentity

A cadeia de caracteres do identificador de instância do provedor. Essa cadeia de caracteres é retornada de GetProviderInstanceID.

Valor retornado

Os valores retornados possíveis incluem, mas não se limitam a, o seguinte.

Valor/código retornado	Descrição
S_OK	O método foi concluído com sucesso.
E_INVALIDARG	O valor de pszCategoryIdentity é inválido.
E_OUTOFMEMORY	O método não pode alocar a memória necessária para executar essa operação.
E_ACCESSDENIED	O usuário não tem permissão de acesso suficiente para executar a ação solicitada.
HRESULT_FROM_WIN32(ERROR_FILE_NOT_FOUND) 0x80070002	O valor de pszCategory ou pszSubCategory é desconhecido.

Comentários

A permissão de acesso para alterar HKEY_LOCAL_MACHINE\SYSTEM chaves do Registro é necessária para adicionar ou remover instâncias de função usando o provedor do Registro (níveis de acesso do Administrador ou do Power User). O usuário deve ter acesso de Administrador para remover uma instância de função em todo o sistema.

Nota Esse método não tem suporte de todos os provedores.

 

Requisitos

Cliente mínimo com suporte	Windows Vista [somente aplicativos da área de trabalho]
Servidor mínimo com suporte	Windows Server 2008 [somente aplicativos da área de trabalho]
Plataforma de Destino	Windows
Cabeçalho	functiondiscoveryapi.h
DLL	FunDisc.dll

Confira também

IFunctionDiscovery