Método INetFwServices::Item (netfw.h)
[A API do Firewall do Windows está disponível para uso nos sistemas operacionais especificados na seção Requisitos. Ele poderá ser alterado ou ficar indisponível em versões subsequentes. Para o Windows Vista e posterior, é recomendável usar o Firewall do Windows com a API de Segurança Avançada.]
Retorna o serviço especificado se ele estiver na coleção.
Sintaxe
HRESULT Item(
[in] NET_FW_SERVICE_TYPE svcType,
[out] INetFwService **service
);
Parâmetros
[in] svcType
| C++ | Tipo de serviço a ser buscado. |
| VB | Tipo de serviço a ser buscado. Consulte NET_FW_SERVICE_TYPE |
[out] service
| C++ | Referência ao objeto INetFwService retornado. |
| VB | Referência ao objeto INetFwService retornado. |
Retornar valor
C++
| Código de retorno | Descrição |
|---|---|
|
A operação foi anulada devido a problemas de permissões. |
|
O método não pôde alocar a memória necessária. |
|
O método falhou devido a um ponteiro inválido. |
|
O método falhou devido a um parâmetro inválido. |
|
O método falhou porque o item solicitado não existe. |
VB
Se o método for bem-sucedido, 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 |
|---|---|
|
A operação foi anulada devido a problemas de permissões. |
|
O método não pôde alocar a memória necessária. |
|
O método falhou devido a um ponteiro inválido. |
|
O método falhou devido a um parâmetro inválido. |
|
O método falhou porque o item solicitado não existe. |
Requisitos
| Requisito | Valor |
|---|---|
| Cliente mínimo com suporte | Windows Vista, Windows XP com SP2 [somente aplicativos da área de trabalho] |
| Servidor mínimo com suporte | Windows Server 2003 com SP1 [somente aplicativos da área de trabalho] |
| Plataforma de Destino | Windows |
| Cabeçalho | netfw.h |
| DLL | FirewallAPI.dll; Hnetcfg.dll no Windows XP com SP2 |