Funzione GetNameByTypeA (nspapi.h)

Articolo
11/20/2024

La funzione GetNameByType recupera il nome di un servizio di rete per il tipo di servizio specificato.

Nota La funzione GetNameByType è un'estensione specifica di Microsoft per la specifica Windows Sockets 1.1. Questa funzione è obsoleta. Per praticità degli sviluppatori windows Sockets 1.1, il materiale di riferimento è il seguente.

Nota Le funzioni descritte in Protocol-Independent risoluzione dei nomi forniscono funzionalità equivalenti in Windows Sockets 2.

Sintassi

INT GetNameByTypeA(
  [in]  LPGUID lpServiceType,
  [out] LPSTR  lpServiceName,
  [in]  DWORD  dwNameLength
);

Parametri

[in] lpServiceType

Puntatore a un identificatore univoco globale (GUID) che specifica il tipo del servizio di rete. Il file di intestazione Svcguid. h include definizioni di diversi tipi di servizio GUID e macro per usarle.

Il file di intestazione Svcguid.h non viene incluso automaticamente dal file di intestazione Winsock2.h.

[out] lpServiceName

Puntatore a un buffer per ricevere una stringa con terminazione zero che rappresenta in modo univoco il nome del servizio di rete.

[in] dwNameLength

Puntatore a una variabile che, in input, specifica le dimensioni, in byte, del buffer a cui punta lpServiceName. Nell'output, la variabile contiene le dimensioni effettive della stringa del nome del servizio, in byte.

Valore restituito

Se la funzione ha esito positivo, il valore restituito non è SOCKET_ERROR (–1).

Se la funzione ha esito negativo, il valore restituito è SOCKET_ERROR (-1). Per ottenere informazioni estese sull'errore, chiamare GetLastError.

Osservazioni

Nota

L'intestazione nspapi.h definisce GetNameByType come alias che seleziona automaticamente la versione ANSI o Unicode di questa funzione in base alla definizione della costante del preprocessore UNICODE. La combinazione dell'utilizzo dell'alias indipendente dalla codifica con il codice non indipendente dalla codifica può causare mancate corrispondenze che generano errori di compilazione o di runtime. Per altre informazioni, vedere convenzioni di per i prototipi di funzioni.

Fabbisogno

Requisito	Valore
client minimo supportato	Windows 2000 Professional [solo app desktop]
server minimo supportato	Windows 2000 Server [solo app desktop]
piattaforma di destinazione	Finestre
intestazione	nspapi.h
libreria	Mswsock.lib
dll	Mswsock.dll

Vedere anche

GetTypeByName

Funzioni Winsock

di riferimento winsock

Condividi tramite