RPC_IF_CALLBACK_FN Rückruffunktion (rpcdce.h)

  • Artikel

Die RPC_IF_CALLBACK_FN ist ein Prototyp für eine Sicherheitsrückruffunktion, die Ihre Anwendung bereitstellt. Ihr Programm kann eine Rückruffunktion für jede schnittstelle bereitstellen, die es definiert.

Syntax

RPC_IF_CALLBACK_FN RpcIfCallbackFn;

RPC_STATUS RpcIfCallbackFn(
       RPC_IF_HANDLE InterfaceUuid,
  [in] void *Context
)
{...}

Parameter

InterfaceUuid

[in] Context

Zeiger auf ein RPC_IF_ID Serverbindungshandle, das den Client darstellt. In der Funktionsdeklaration muss dies vom Typ RPC_IF_HANDLE sein, aber es handelt sich um ein Clientbindungshandle, das sicher in diese umgewandelt werden kann. Die Rückruffunktion kann dieses Handle an RpcImpersonateClient, RpcBindingServerFromClient, RpcGetAuthorizationContextForClient oder eine andere serverseitige Funktion übergeben, die ein Clientbindungshandle akzeptiert, um Informationen über den Client abzurufen.

Rückgabewert

Die Rückruffunktion sollte RPC_S_OK zurückgeben, wenn der Client Methoden in dieser Schnittstelle aufrufen darf. Jeder andere Rückgabecode bewirkt, dass der Client die Ausnahme RPC_S_ACCESS_DENIED empfängt.

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

Hinweise

In einigen Fällen kann die RPC-Laufzeit die Sicherheitsrückruffunktion mehrmals pro Client und Schnittstelle aufrufen. Stellen Sie sicher, dass Ihre Rückruffunktion diese Möglichkeit verarbeiten kann.

Der Sicherheitsrückruf muss als RPC_ENTRY deklariert werden.

Anforderungen

Anforderung Wert
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 (rpc.h einschließen)

Weitere Informationen

RpcServerRegisterIfEx