RpcMgmtInqIfIds-Funktion (rpcdce.h)

  • Artikel

Die RpcMgmtInqIfIds-Funktion gibt einen Vektor zurück, der die Bezeichner der vom Server angebotenen Schnittstellen enthält.

Syntax

RPC_STATUS RpcMgmtInqIfIds(
  RPC_BINDING_HANDLE Binding,
  RPC_IF_ID_VECTOR   **IfIdVector
);

Parameter

Binding

Geben Sie zum Empfangen von Schnittstellenbezeichnern zu einer Remoteanwendung ein Serverbindungshandle für diese Anwendung an. Um Schnittstelleninformationen zu Ihrer eigenen Anwendung zu erhalten, geben Sie den Wert NULL an.

IfIdVector

Gibt die Adresse eines Schnittstellenbezeichnervektors zurück.

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 RpcMgmtInqIfIds-Funktion auf, um einen Vektor von Schnittstellenbezeichnern über den angegebenen Server aus der RPC-Laufzeitbibliothek abzurufen.

Die RPC-Laufzeitbibliothek weist Arbeitsspeicher für den Schnittstellenbezeichnervektor zu. Die Anwendung ist für den Aufruf der RpcIfIdVectorFree-Funktion verantwortlich, um den von diesem Vektor 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

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

Weitere Informationen

RpcIfIdVectorFree