PGET_INTERFACE_INFO funzione di callback (routprot.h)

Articolo
03/01/2024

La funzione GetInterfaceInfo ottiene le informazioni di configurazione mantenute dal protocollo di routing per un'interfaccia specifica.

Sintassi

PGET_INTERFACE_INFO PgetInterfaceInfo;

DWORD PgetInterfaceInfo(
  [in]      ULONG InterfaceIndex,
  [in]      PVOID InterfaceInfo,
  [in, out] PULONG BufferSize,
  [in]      PULONG StructureVersion,
  [in]      PULONG StructureSize,
  [in]      PULONG StructureCount
)
{...}

Parametri

[in] InterfaceIndex

Specifica l'interfaccia nel set di interfacce configurate nel router.

[in] InterfaceInfo

Puntatore a un buffer che riceve le informazioni di configurazione definite dal protocollo associate all'interfaccia . Queste informazioni sono private per il protocollo di routing.

[in, out] BufferSize

Puntatore a una variabile DWORD .

In input: questa variabile specifica le dimensioni, in byte, del buffer fornito per ricevere le informazioni di configurazione.

In output: questa variabile riceve le dimensioni, in byte, dei dati inseriti nel buffer. Se le dimensioni iniziali non sono sufficienti, questa variabile contiene le dimensioni necessarie per contenere tutti i dati.

[in] StructureVersion

Specifica la versione delle strutture informative a cui punta il parametro InterfaceInfo . In alcuni casi, è uguale alla versione del protocollo di routing.

[in] StructureSize

Specifica le dimensioni di ognuna delle strutture informative a cui punta il parametro InterfaceInfo . Poiché alcune strutture di informazioni contengono membri a lunghezza variabile, il protocollo di routing non è necessariamente in grado di determinare le dimensioni delle informazioni dalla versione.

[in] StructureCount

Specifica un conteggio del numero di strutture di informazioni a cui punta il parametro InterfaceInfo . Questo parametro è sempre uno.

Valore restituito

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

Se la funzione ha esito negativo, il valore restituito è uno dei codici di errore seguenti.

Valore	Descrizione
ERROR_CAN_NOT_COMPLETE	Tentativo di recupero delle informazioni non riuscite.
ERROR_INVALID_PARAMETER	Il parametro InterfaceIndex non è valido (ad esempio, nessuna interfaccia esiste con tale indice) o il parametro InterfaceInfoSize è NULL.
ERROR_INSUFFICIENT_BUFFER	Le dimensioni del buffer di output fornito non sono sufficienti per contenere le informazioni richieste. La dimensione richiesta viene restituita nella variabile DWORD a cui punta InterfaceInfoSize.

Requisiti

Requisito	Valore
Client minimo supportato	Nessuno supportato
Server minimo supportato	Windows 2000 Server [solo app desktop]
Piattaforma di destinazione	Windows
Intestazione	routprot.h

Vedi anche

Funzioni dell'interfaccia del protocollo di routing

Riferimento all'interfaccia del protocollo di routing

SetInterfaceInfo

Condividi tramite