Método INetFwRules::Item (netfw.h)

O método Item retornará a regra especificada se ela estiver na coleção.

Sintaxe

HRESULT Item(
  [in]  BSTR       name,
  [out] INetFwRule **rule
);

[in] name

Nome da regra a ser recuperada.

[out] rule

Referência ao objeto INetFwRule retornado.

Se o método tiver êxito, o valor retornado será S_OK.

Se o método falhar, o valor retornado será um dos seguintes códigos de erro.

Código de retorno	Descrição
E_ACCESSDENIED	A operação foi anulada devido a problemas de permissões.
E_INVALIDARG	O método falhou devido a um parâmetro inválido.
E_OUTOFMEMORY	O método não pôde alocar a memória necessária.
E_POINTER	O método falhou devido a um ponteiro inválido.
HRESULT_FROM_WIN32(ERROR_FILE_NOT_FOUND)	O item solicitado não existe.

Se o método tiver êxito, o valor retornado será S_OK.

Se o método falhar, o valor retornado será um dos seguintes códigos de erro.

Código de retorno	Descrição
E_ACCESSDENIED	A operação foi anulada devido a problemas de permissões.
E_INVALIDARG	O método falhou devido a um parâmetro inválido.
E_OUTOFMEMORY	O método não pôde alocar a memória necessária.
E_POINTER	O método falhou devido a um ponteiro inválido.
HRESULT_FROM_WIN32(ERROR_FILE_NOT_FOUND)	O item solicitado não existe.

Requisito	Valor
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	netfw.h
DLL	FirewallAPI.dll