Funzione WNetGetProviderNameA (winnetwk.h)
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 |
|---|---|
|
Il buffer è troppo piccolo per contenere il nome del provider di rete. |
|
La rete non è disponibile. |
|
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 |