Função GetOwnerModuleFromTcp6Entry (iphlpapi.h)

A função GetOwnerModuleFromTcp6Entry recupera dados sobre o módulo que emitiu a associação de contexto para um ponto de extremidade TCP IPv6 específico em uma linha de tabela MIB.

Sintaxe

IPHLPAPI_DLL_LINKAGE DWORD GetOwnerModuleFromTcp6Entry(
  [in]      PMIB_TCP6ROW_OWNER_MODULE     pTcpEntry,
  [in]      TCPIP_OWNER_MODULE_INFO_CLASS Class,
  [out]     PVOID                         pBuffer,
  [in, out] PDWORD                        pdwSize
);

Parâmetros

[in] pTcpEntry

Um ponteiro para uma estrutura de MIB_TCP6ROW_OWNER_MODULE que contém a entrada de ponto de extremidade TCP IPv6 usada para obter o módulo proprietário.

[in] Class

Um TCPIP_OWNER_MODULE_INFO_CLASS valor de enumeração que indica o tipo de dados a serem obtidos em relação ao módulo proprietário. A enumeração TCPIP_OWNER_MODULE_INFO_CLASS é definida no arquivo de cabeçalho Iprtrmib.h .

Esse parâmetro deve ser definido como TCPIP_OWNER_MODULE_INFO_BASIC.

[out] pBuffer

Um ponteiro para um buffer que contém uma estrutura TCPIP_OWNER_MODULE_BASIC_INFO com os dados do módulo proprietário. O tipo de dados retornados nesse buffer é indicado pelo valor do parâmetro Class .

As estruturas a seguir são usadas para os dados em Buffer quando Class é definido como o valor correspondente.

Valor de enumeração de classe Formato de dados do buffer
TCPIP_OWNER_MODULE_BASIC_INFO TCPIP_OWNER_MODULE_BASIC_INFO

[in, out] pdwSize

O tamanho estimado da estrutura retornada em Buffer, em bytes. Se esse valor for definido muito pequeno, ERROR_INSUFFICIENT_BUFFER será retornado por essa função e esse campo conterá o tamanho correto da estrutura.

Valor retornado

Se a chamada de função for bem-sucedida, o valor NO_ERROR será retornado.

Se a função falhar, o valor retornado será um dos códigos de erro a seguir.

Código de retorno Descrição
ERROR_INSUFFICIENT_BUFFER
Espaço insuficiente foi alocado para a tabela. O tamanho da tabela é retornado no parâmetro pdwSize e deve ser usado em uma chamada subsequente para essa função para recuperar a tabela com êxito.
ERROR_INVALID_PARAMETER
Um parâmetro está incorreto. Esse valor será retornado se um dos parâmetros pTcpEntry ou pdwSize for NULL. Esse valor também será retornado se o parâmetro Class não for igual a TCPIP_OWNER_MODULE_INFO_BASIC.
ERROR_NOT_ENOUGH_MEMORY
Não há memória disponível suficiente para concluir a operação.
ERROR_NOT_FOUND
O elemento não foi encontrado. Esse valor será retornado se o membro dwOwningPid do MIB_TCP6ROW_OWNER_MODULE apontado pelo parâmetro pTcpEntry for zero ou não puder ser encontrado.
ERROR_PARTIAL_COPY
Somente parte de uma solicitação foi concluída.

Comentários

O parâmetro Buffer contém não apenas uma estrutura com ponteiros para dados específicos, por exemplo, ponteiros para as cadeias de caracteres terminadas em zero que contêm o nome e o caminho do módulo proprietário, mas os próprios dados reais; que são as cadeias de caracteres de nome e caminho. Portanto, ao calcular o tamanho do buffer, verifique se você tem espaço suficiente para a estrutura, bem como para os dados para os quais os membros da estrutura apontam.

A resolução de entradas de tabela TCP para módulos de proprietário é uma prática recomendada. Em alguns casos, o nome do módulo proprietário retornado na estrutura TCPIP_OWNER_MODULE_BASIC_INFO pode ser um nome de processo (como "svchost.exe"), um nome de serviço (como "RPC" ou um nome de componente (como "timer.dll").

Para computadores em execução no Windows Vista ou posterior, os membros pModuleName e pModulePath do TCPIP_OWNER_MODULE_BASIC_INFO recuperados pela função GetOwnerModuleFromTcpEntry podem apontar para uma cadeia de caracteres vazia para algumas conexões TCP. Os aplicativos que iniciam conexões TCP localizadas na pasta do sistema Windows (C:\Windows\System32, por padrão) são considerados protegidos. Se a função GetOwnerModuleFromTcpEntry for chamada por um usuário que não seja membro do grupo Administradores, a chamada de função terá êxito, mas os membros pModuleName e pModulePath apontarão para a memória que contém uma cadeia de caracteres vazia para as conexões TCP iniciadas por aplicativos protegidos.

Para computadores em execução no Windows Vista ou posterior, o acesso aos membros pModuleName e pModulePath da estrutura TCPIP_OWNER_MODULE_BASIC_INFO é limitado pelo UAC (controle de conta de usuário). Se um aplicativo que chama essa função for executado por um usuário conectado como um membro do grupo Administradores diferente do Administrador interno, essa chamada terá êxito, mas o acesso a esses membros retornará uma cadeia de caracteres vazia, a menos que o aplicativo tenha sido marcado no arquivo de manifesto com um requestedExecutionLevel definido como requireAdministrator. Se o aplicativo no Windows Vista ou posterior não tiver esse arquivo de manifesto, um usuário conectado como membro do grupo Administradores que não seja o Administrador interno deverá executar o aplicativo em um shell avançado como administrador interno (administrador RunAs) para acesso aos membros pModuleName e pModulePath protegidos a serem permitidos.

Requisitos

   
Cliente mínimo com suporte Windows Vista, Windows XP com SP2 [somente aplicativos da área de trabalho]
Servidor mínimo com suporte Windows Server 2008, Windows Server 2003 com SP1 [somente aplicativos da área de trabalho]
Plataforma de Destino Windows
Cabeçalho iphlpapi.h
Biblioteca Iphlpapi.lib
DLL Iphlpapi.dll

Confira também

MIB_TCP6ROW_OWNER_MODULE

TCPIP_OWNER_MODULE_INFO_CLASS