RpcMgmtSetAuthorizationFn-Funktion (rpcdce.h)

  • Artikel

Die RpcMgmtSetAuthorizationFn-Funktion richtet eine Autorisierungsfunktion für die Verarbeitung von Remoteaufrufen der Verwaltungsfunktionen eines Servers ein.

Syntax

RPC_STATUS RpcMgmtSetAuthorizationFn(
  RPC_MGMT_AUTHORIZATION_FN AuthorizationFn
);

Parameter

AuthorizationFn

Gibt eine Autorisierungsfunktion an. Die Laufzeitbibliothek des RPC-Servers ruft diese Funktion automatisch auf, wenn die Serverlaufzeit eine Clientanforderung zum Ausführen einer der Remoteverwaltungsfunktionen empfängt. Der Server muss diese Funktion implementieren. Anwendungen geben den Wert NULL an, um die Registrierung einer zuvor registrierten Autorisierungsfunktion aufzuheben. Nach einem solchen Aufruf werden Standardautorisierungen verwendet.

Rückgabewert

Wert Bedeutung
RPC_S_OK
 Der Aufruf war erfolgreich.
 
Hinweis Eine Liste der gültigen Fehlercodes finden Sie unter RPC-Rückgabewerte.
 

Hinweise

Serveranwendungen rufen die RpcMgmtSetAuthorizationFn-Funktion auf, um eine Autorisierungsfunktion einzurichten, die den Zugriff auf die Remoteverwaltungsfunktionen des Servers steuert. Wenn ein Server nicht RpcMgmtSetAuthorizationFn aufgerufen hat oder mit einem NULL-Wert für AuthorizationFn aufruft, verwendet die Laufzeitbibliothek des Servers die folgenden Standardautorisierungen.

Remotefunktion Standardautorisierung
RpcMgmtInqIfIds Aktiviert
RpcMgmtInqServerPrincName Aktiviert
RpcMgmtInqStats Aktiviert
RpcMgmtIsServerListening Aktiviert
RpcMgmtStopServerListening Disabled
 
 

In der obigen Tabelle gibt "Aktiviert" an, dass alle Clients die Remotefunktion ausführen können, und "Deaktiviert" gibt an, dass alle Clients daran gehindert sind, die Remotefunktion auszuführen.

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 (include Rpc.h)
Bibliothek Rpcrt4.lib
DLL Rpcrt4.dll

Weitere Informationen

RPC_MGMT_AUTHORIZATION_FN

RpcMgmtInqStats

RpcMgmtIsServerListening

RpcMgmtStopServerListening

RpcMgmtWaitServerListen