Função WNetGetProviderNameW (winnetwk.h)

  • Artigo

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

Sintaxe

DWORD WNetGetProviderNameW(
  [in]      DWORD   dwNetType,
  [out]     LPWSTR  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 retornado

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 conter 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.

Comentários

Observação

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 de pré-processador UNICODE. Misturar o uso do alias neutro de codificação com código que não seja neutro em codificação pode levar a incompatibilidades que resultam em erros de compilação ou de runtime. Para obter mais informações, consulte Convenções para protótipos de função.

Requisitos

   
Cliente mínimo com suporte Windows 2000 Professional [somente aplicativos da área de trabalho]
Servidor mínimo com suporte Windows 2000 Server [somente aplicativos da área de trabalho]
Plataforma de Destino Windows
Cabeçalho winnetwk.h
Biblioteca Mpr.lib
DLL Mpr.dll

Confira também

WNetGetNetworkInformation

WNetGetResourceInformation

WNetGetUniversalName

Visão geral da rede do Windows (WNet)

Funções de rede do Windows