Função WNetGetProviderNameA (winnetwk.h)

Artigo
11/20/2024

A função WNetGetProviderName obtém o nome do provedor para um tipo específico de rede.

Sintaxe

DWORD WNetGetProviderNameA(
  [in]      DWORD   dwNetType,
  [out]     LPSTR   lpProviderName,
  [in, out] LPDWORD lpBufferSize
);

Parâmetros

[in] dwNetType

Tipo de rede exclusivo da rede. Se duas redes reivindicarem o mesmo tipo, a função retornará o nome do provedor carregado primeiro. Somente a palavra alta do tipo de rede é usada. Se uma rede relatar um subtipo na palavra baixa, ela será ignorada.

Você pode encontrar uma lista completa de tipos de rede no arquivo de cabeçalho Winnetwk.h.

[out] lpProviderName

Ponteiro para um buffer que recebe o nome do provedor de rede.

[in, out] lpBufferSize

Tamanho do buffer passado para a função, em caracteres. Se o valor retornado for ERROR_MORE_DATA, lpBufferSize retornará o tamanho do buffer necessário (em caracteres) para manter o nome do provedor.

Windows Me/98/95: O tamanho do buffer está em bytes, não em caracteres. Além disso, o buffer deve ter pelo menos 1 byte de comprimento.

Valor de retorno

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

Se a função falhar, o valor retornado será um código de erro do sistema, como um dos valores a seguir.

Código de retorno	Descrição
ERROR_MORE_DATA	O buffer é muito pequeno para manter o nome do provedor de rede.
ERROR_NO_NETWORK	A rede não está disponível.
ERROR_INVALID_ADDRESS	O parâmetro lpProviderName ou o parâmetro lpBufferSize é inválido.

Observações

Nota

O cabeçalho winnetwk.h define WNetGetProviderName como um alias que seleciona automaticamente a versão ANSI ou Unicode dessa função com base na definição da constante do pré-processador UNICODE. A combinação do uso do alias neutro de codificação com código que não é neutro em codificação pode levar a incompatibilidades que resultam em erros de compilação ou de runtime. Para obter mais informações, consulte Conventions for Function Prototypes.

Requisitos

Requisito	Valor
de cliente com suporte mínimo	Windows 2000 Professional [somente aplicativos da área de trabalho]
servidor com suporte mínimo	Windows 2000 Server [somente aplicativos da área de trabalho]
da Plataforma de Destino	Windows
cabeçalho	winnetwk.h
biblioteca	Mpr.lib
de DLL	Mpr.dll

Consulte também

WNetGetNetworkInformation

WNetGetResourceInformation

WNetGetUniversalName

Visão geral WNet (Rede windows)

funções de rede do Windows

Compartilhar via