Share via


Método INapComponentConfig3::NewConfig

Observação

A plataforma de Proteção de Acesso à Rede não está disponível a partir do Windows 10

O método NewConfig é implementado por SHVs (validadores de integridade do sistema) para fornecer uma maneira de criar dados de configuração para uma ID de configuração específica. Quando essa função é chamada, um SHV deve alocar novos dados de configuração e preenchê-los com uma cópia dos dados de configuração padrão.

Sintaxe

HRESULT NewConfig(
   UINT32 configID
);

Parâmetros

configID

Um valor que representa a configuração. ConfigID é atribuído pelo serviço NPS (Servidor de Política de Rede) e é exclusivo dentro do SHV.

Valor retornado

Retorna um dos seguintes códigos de erro com base no resultado dessa operação.

Código de retorno Descrição
S_OK
A operação teve êxito.
E_INVALIDARG
ConfigID é 0 (um valor reservado para a configuração padrão).
NAP_E_SHV_CONFIG_EXISTED
ConfigID já existe. A lista de IDs conhecidas por NPS é diferente da SHV.

Comentários

Depois que a nova configuração for criada pelo NewConfig, os métodos GetConfigFromID, InvokeUIFromConfigBlob e SetConfigToID deverão ser usados para alterar a configuração conforme necessário.

Requisitos

Requisito Valor
Cliente mínimo com suporte
Nenhum compatível
Servidor mínimo com suporte
Windows Server 2008 R2 [somente aplicativos da área de trabalho]
Cabeçalho
NapCommon.h
IDL
NapCommon.idl

Confira também

INapComponentConfig3