NDK_FN_GET_LISTENER_LOCAL_ADDRESS Rückruffunktion (ndkpi.h)

Die Funktion NdkGetListenerLocalAddress (NDK_FN_GET_LISTENER_LOCAL_ADDRESS) gibt die lokale Adresse für einen NDK-Listener zurück.

Syntax

NDK_FN_GET_LISTENER_LOCAL_ADDRESS NdkFnGetListenerLocalAddress;

NTSTATUS NdkFnGetListenerLocalAddress(
  [in] NDK_LISTENER *pNdkListener,
       PSOCKADDR pAddress,
       ULONG *pAddressLength
)
{...}

Parameter

[in] pNdkListener

Ein Zeiger auf ein NDK-Listenerobjekt (NDK_LISTENER).

pAddress

In diesem Puffer wird eine lokale Adresse für einen Listener zurückgegeben.

pAddressLength

Die Größe des Adresspuffers für die Eingabe in Bytes und die Größe der tatsächlichen Adresse, die für die Ausgabe in den Puffer geschrieben wird.

Rückgabewert

Die NdkGetListenerLocalAddress-Funktion gibt einen der folgenden NTSTATUS-Codes zurück.

Rückgabecode	Beschreibung
STATUS_SUCCESS	Im pAddress-Parameter wurde eine lokale Adresse in den Puffer geschrieben.
STATUS_BUFFER_TOO_SMALL	Die Puffergröße, die in der Eingabe des *pAddressLength-Parameters angegeben ist, ist zu klein. *pAddressLength-Ausgabewert wird mit der erforderlichen Puffergröße aktualisiert.
Andere status Codes	Ein Fehler ist aufgetreten.

Hinweise

NdkGetListenerLocalAddress gibt die lokale Adresse für einen Listener zurück. Die lokale Adresse ist nützlich, um Portinformationen für einen AF_INET- oder AF_INET6-Listener abzurufen. Wenn der NDK-Consumer beispielsweise null als ND-Portnummer in einer Listenanforderung angibt und der NDK-Anbieter einen Port angibt, kann der NDK-Consumer NdkGetListenerLocalAddress verwenden, um zu bestimmen, welchen Port der Anbieter angegeben hat.

Anforderungen

Anforderung	Wert
Unterstützte Mindestversion (Client)	Keine unterstützt, wird in NDIS 6.30 und höher unterstützt.
Unterstützte Mindestversion (Server)	Windows Server 2012
Zielplattform	Windows
Kopfzeile	ndkpi.h (include Ndkpi.h)
IRQL	<=DISPATCH_LEVEL

Weitere Informationen

NDK_FN_LISTEN

NDK_LISTENER