RpcMgmtInqStats-Funktion (rpcdce.h)

Artikel
08/25/2023

Die RpcMgmtInqStats-Funktion gibt RPC-Laufzeitstatistiken zurück.

Syntax

RPC_STATUS RpcMgmtInqStats(
  RPC_BINDING_HANDLE Binding,
  RPC_STATS_VECTOR   **Statistics
);

Parameter

Binding

Um Statistiken zu einer Remoteanwendung zu erhalten, geben Sie ein Serverbindungshandle für diese Anwendung an. Um Statistiken zu Ihrer eigenen (lokalen) Anwendung zu erhalten, geben Sie den Wert NULL an.

Statistics

Gibt einen Zeiger auf einen Zeiger auf die Statistiken über den Server zurück, der durch den Binding-Parameter angegeben wird. Jede Statistik ist ein nicht signierter long-Wert .

Rückgabewert

Wert	Bedeutung
RPC_S_OK	Der Aufruf war erfolgreich.
RPC_S_INVALID_BINDING	Das Bindungshandle war ungültig.
RPC_S_WRONG_KIND_OF_BINDING	Dies war die falsche Art der Bindung für den Vorgang.

Hinweis Eine Liste der gültigen Fehlercodes finden Sie unter RPC-Rückgabewerte.

Hinweise

Eine Anwendung ruft die RpcMgmtInqStats-Funktion auf, um Statistiken über den angegebenen Server aus der RPC-Laufzeitbibliothek abzurufen.

Jedes Arrayelement im zurückgegebenen Statistikvektor enthält einen unsignierten Long-Wert . In der folgenden Tabelle werden die Statistiken beschrieben, die von der angegebenen Konstante indiziert werden.

Statistik	BESCHREIBUNG
RPC_C_STATS_CALLS_IN	Anzahl der Remoteprozeduraufrufe, die vom RPC-Server empfangen werden, der durch das Bindungshandle angegeben wird.
RPC_C_STATS_CALLS_OUT	Anzahl von Remoteprozeduraufrufen, die vom RPC-Server initiiert werden, der durch das Bindungshandle angegeben wird.
RPC_C_STATS_PKTS_IN	Anzahl der vom RPC-Server empfangenen Netzwerkpakete, die vom Bindungshandle angegeben werden.
RPC_C_STATS_PKTS_OUT	Anzahl der vom RPC-Server gesendeten Netzwerkpakete, die durch das Bindungshandle angegeben werden.

Die RPC-Laufzeitbibliothek weist Arbeitsspeicher für den Statistikvektor zu. Die Anwendung ist für den Aufruf der RpcMgmtStatsVectorFree-Funktion verantwortlich, um den vom Statistikvektor verwendeten Arbeitsspeicher freizugeben.

Der Server muss auf Remoteprozeduraufrufe lauschen, damit diese Funktion erfolgreich ist. Wenn der Server nicht lauscht, schlägt die Funktion fehl.

Anforderungen

Anforderung	Wert
Unterstützte Mindestversion (Client)	Windows 2000 Professional [Desktop-Apps \| UWP-Apps]
Unterstützte Mindestversion (Server)	Windows 2000 Server [Desktop-Apps \| UWP-Apps]
Zielplattform	Windows
Kopfzeile	rpcdce.h (include Rpc.h)
Bibliothek	Rpcrt4.lib
DLL	Rpcrt4.dll

Weitere Informationen

RpcEpResolveBinding

RpcMgmtStatsVectorFree

Freigeben über