GetOwnerModuleFromTcp6Entry-Funktion (iphlpapi.h)

Die GetOwnerModuleFromTcp6Entry-Funktion ruft Daten zu dem Modul ab, das die Kontextbindung für einen bestimmten IPv6-TCP-Endpunkt in einer MIB-Tabellenzeile ausgegeben hat.

Syntax

IPHLPAPI_DLL_LINKAGE DWORD GetOwnerModuleFromTcp6Entry(
  [in]      PMIB_TCP6ROW_OWNER_MODULE     pTcpEntry,
  [in]      TCPIP_OWNER_MODULE_INFO_CLASS Class,
  [out]     PVOID                         pBuffer,
  [in, out] PDWORD                        pdwSize
);

Parameter

[in] pTcpEntry

Ein Zeiger auf eine MIB_TCP6ROW_OWNER_MODULE-Struktur , die den IPv6-TCP-Endpunkteintrag enthält, der zum Abrufen des Besitzermoduls verwendet wird.

[in] Class

Ein TCPIP_OWNER_MODULE_INFO_CLASS Enumerationswert, der den Typ der Daten angibt, die für das Besitzermodul abgerufen werden sollen. Die TCPIP_OWNER_MODULE_INFO_CLASS-Enumeration ist in der Headerdatei Iprtrmib.h definiert.

Dieser Parameter muss auf TCPIP_OWNER_MODULE_INFO_BASIC festgelegt werden.

[out] pBuffer

Ein Zeiger auf einen Puffer, der eine TCPIP_OWNER_MODULE_BASIC_INFO Struktur mit den Daten des Besitzermoduls enthält. Der Typ der in diesem Puffer zurückgegebenen Daten wird durch den Wert des Class-Parameters angegeben.

Die folgenden Strukturen werden für die Daten in Buffer verwendet, wenn Class auf den entsprechenden Wert festgelegt ist.

Klassenaufzählungswert	Pufferdatenformat
TCPIP_OWNER_MODULE_BASIC_INFO	TCPIP_OWNER_MODULE_BASIC_INFO

[in, out] pdwSize

Die geschätzte Größe der im Puffer zurückgegebenen Struktur in Bytes. Wenn dieser Wert zu klein festgelegt ist, wird ERROR_INSUFFICIENT_BUFFER von dieser Funktion zurückgegeben, und dieses Feld enthält die richtige Strukturgröße.

Rückgabewert

Wenn der Funktionsaufruf erfolgreich ist, wird der Wert NO_ERROR zurückgegeben.

Wenn die Funktion fehlschlägt, ist der Rückgabewert einer der folgenden Fehlercodes.

Rückgabecode	Beschreibung
ERROR_INSUFFICIENT_BUFFER	Für die Tabelle wurde nicht genügend Speicherplatz zugewiesen. Die Größe der Tabelle wird im pdwSize-Parameter zurückgegeben und muss in einem nachfolgenden Aufruf dieser Funktion verwendet werden, um die Tabelle erfolgreich abzurufen.
ERROR_INVALID_PARAMETER	Ein Parameter ist falsch. Dieser Wert wird zurückgegeben, wenn einer der pTcpEntry - oder pdwSize-ParameterNULL ist. Dieser Wert wird auch zurückgegeben, wenn der Class-Parameter nicht gleich TCPIP_OWNER_MODULE_INFO_BASIC ist.
ERROR_NOT_ENOUGH_MEMORY	Es ist nicht genügend Arbeitsspeicher verfügbar, um den Vorgang abzuschließen.
ERROR_NOT_FOUND	Das Element wurde nicht gefunden. Dieser Wert wird zurückgegeben, wenn das dwOwningPid-Element des MIB_TCP6ROW_OWNER_MODULE , auf das der pTcpEntry-Parameter verweist, null war oder nicht gefunden werden konnte.
ERROR_PARTIAL_COPY	Nur ein Teil einer Anforderung wurde abgeschlossen.

Hinweise

Der Buffer-Parameter enthält nicht nur eine Struktur mit Zeigern auf bestimmte Daten, z. B. Zeiger auf die Zeichenfolgen, die den Namen und pfad des Besitzermoduls enthalten, sondern auch die tatsächlichen Daten selbst. dies ist der Name und die Pfadzeichenfolgen. Stellen Sie daher beim Berechnen der Größe des Puffers sicher, dass genügend Speicherplatz für die Struktur und die Daten vorhanden ist, auf die die Elemente der Struktur verweisen.

Die Auflösung von TCP-Tabelleneinträgen in Besitzermodule ist eine bewährte Methode. In einigen Fällen kann der in der TCPIP_OWNER_MODULE_BASIC_INFO-Struktur zurückgegebene Besitzermodulname ein Prozessname (z. B. "svchost.exe"), ein Dienstname (z. B. "RPC") oder ein Komponentenname (z. B. "timer.dll") sein.

Bei Computern, die unter Windows Vista oder höher ausgeführt werden, können die pModuleName - und pModulePath-Member der TCPIP_OWNER_MODULE_BASIC_INFO , die von der GetOwnerModuleFromTcpEntry-Funktion abgerufen werden, auf eine leere Zeichenfolge für einige TCP-Verbindungen verweisen. Anwendungen, die TCP-Verbindungen im Windows-Systemordner (standardmäßig C:\Windows\System32) starten, gelten als geschützt. Wenn die GetOwnerModuleFromTcpEntry-Funktion von einem Benutzer aufgerufen wird, der kein Mitglied der Gruppe Administratoren ist, wird der Funktionsaufruf erfolgreich ausgeführt, aber die Mitglieder pModuleName und pModulePath verweisen auf den Arbeitsspeicher, der eine leere Zeichenfolge für die von geschützten Anwendungen gestarteten TCP-Verbindungen enthält.

Bei Computern, die unter Windows Vista oder höher ausgeführt werden, ist der Zugriff auf die pModuleName - und pModulePath-Member der TCPIP_OWNER_MODULE_BASIC_INFO-Struktur durch die Benutzerkontensteuerung (UAC) eingeschränkt. Wenn eine Anwendung, die diese Funktion aufruft, von einem Benutzer ausgeführt wird, der als Mitglied der Administratorgruppe außer dem integrierten Administrator angemeldet ist, wird dieser Aufruf erfolgreich ausgeführt, aber der Zugriff auf diese Member gibt eine leere Zeichenfolge zurück, es sei denn, die Anwendung wurde in der Manifestdatei mit einem requestedExecutionLevel-Wert gekennzeichnet, der auf requireAdministrator festgelegt ist. Wenn in der Anwendung unter Windows Vista oder höher diese Manifestdatei nicht vorhanden ist, muss ein Benutzer, der sich nicht als der integrierte Administrator als Mitglied der Gruppe Administratoren angemeldet hat, die Anwendung in einer erweiterten Shell als integrierter Administrator (RunAs-Administrator) ausführen, damit der Zugriff auf die geschützten pModuleName - und pModulePath-Member zulässig ist.

Anforderungen

Unterstützte Mindestversion (Client)	Windows Vista, Windows XP mit SP2 [nur Desktop-Apps]
Unterstützte Mindestversion (Server)	Windows Server 2008, Windows Server 2003 mit SP1 [nur Desktop-Apps]
Zielplattform	Windows
Kopfzeile	iphlpapi.h
Bibliothek	Iphlpapi.lib
DLL	Iphlpapi.dll

Weitere Informationen

MIB_TCP6ROW_OWNER_MODULE

TCPIP_OWNER_MODULE_INFO_CLASS