RpcMgmtInqStats-Funktion (rpcdce.h)

  • Artikel

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