Função WNetGetProviderNameA (winnetwk.h)
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 para a 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.
Retornar valor
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 |
|---|---|
|
O buffer é muito pequeno para manter o nome do provedor de rede. |
|
A rede não está disponível. |
|
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
| Requisito | Valor |
|---|---|
| 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 |