Funzione WNetGetProviderNameA (winnetwk.h)

  • Articolo

La funzione WNetGetProviderName ottiene il nome del provider per un tipo specifico di rete.

Sintassi

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

Parametri

[in] dwNetType

Tipo di rete univoco per la rete. Se due reti dichiarano lo stesso tipo, la funzione restituisce prima il nome del provider caricato. Viene usata solo la parola alta del tipo di rete. Se una rete segnala un sottotipo nella parola bassa, viene ignorato.

È possibile trovare un elenco completo dei tipi di rete nel file di intestazione Winnetwk.h.

[out] lpProviderName

Puntatore a un buffer che riceve il nome del provider di rete.

[in, out] lpBufferSize

Dimensioni del buffer passato alla funzione, in caratteri. Se il valore restituito è ERROR_MORE_DATA, lpBufferSize restituisce le dimensioni del buffer necessarie (in caratteri) per contenere il nome del provider.

Windows Me/98/95: Le dimensioni del buffer sono in byte, non caratteri. Inoltre, il buffer deve essere almeno 1 byte lungo.

Valore restituito

Se la funzione ha esito positivo, il valore restituito è NO_ERROR.

Se la funzione ha esito negativo, il valore restituito è un codice di errore di sistema, ad esempio uno dei valori seguenti.

Codice restituito Descrizione
ERROR_MORE_DATA
 Il buffer è troppo piccolo per contenere il nome del provider di rete.
ERROR_NO_NETWORK
 La rete non è disponibile.
ERROR_INVALID_ADDRESS
 Il parametro lpProviderName o il parametro lpBufferSize non è valido.

Commenti

Nota

L'intestazione winnetwk.h definisce WNetGetProviderName come alias che seleziona automaticamente la versione ANSI o Unicode di questa funzione in base alla definizione della costante preprocessore UNICODE. La combinazione dell'utilizzo dell'alias di codifica neutrale con il codice che non è neutrale dalla codifica può causare errori di corrispondenza che causano errori di compilazione o runtime. Per altre informazioni, vedere Convenzioni per i prototipi di funzione.

Requisiti

Requisito Valore
Client minimo supportato Windows 2000 Professional [solo app desktop]
Server minimo supportato Windows 2000 Server [solo app desktop]
Piattaforma di destinazione Windows
Intestazione winnetwk.h
Libreria Mpr.lib
DLL Mpr.dll

Vedi anche

WNetGetNetworkInformation

WNetGetResourceInformation

WNetGetUniversalName

Panoramica di Rete Windows (WNet)

Funzioni di rete Windows