RPC_MGMT_AUTHORIZATION_FN Rückruffunktion (rpcdce.h)

Artikel
08/25/2023

Die RPC_MGMT_AUTHORIZATION_FN ermöglicht Es Serverprogrammen, benutzerdefinierte RPC-Autorisierungstechniken zu implementieren.

Syntax

RPC_MGMT_AUTHORIZATION_FN RpcMgmtAuthorizationFn;

int RpcMgmtAuthorizationFn(
  RPC_BINDING_HANDLE ClientBinding,
  unsigned long RequestedMgmtOperation,
  RPC_STATUS *Status
)
{...}

Parameter

ClientBinding

Client-/Serverbindungshandle.

RequestedMgmtOperation

Der Wert für RequestedMgmtOperation hängt von der angeforderten Remotefunktion ab, wie in der folgenden Tabelle gezeigt.

Aufgerufene Remotefunktion	Bedeutung
RpcMgmtInqIfIds	RPC_C_MGMT_INQ_IF_IDS
RpcMgmtInqServerPrincName	RPC_C_MGMT_INQ_PRINC_NAME
RpcMgmtInqStats	RPC_C_MGMT_INQ_STATS
RpcMgmtIsServerListening	RPC_C_MGMT_IS_SERVER_LISTEN
RpcMgmtStopServerListening	RPC_C_MGMT_STOP_SERVER_LISTEN

Die Autorisierungsfunktion muss alle diese Werte verarbeiten.

Status

Wenn Status entweder 0 (null) oder RPC_S_OK ist, wird der Statuswert RPC_S_ACCESS_DENIED von der Remoteverwaltungsfunktion an den Client zurückgegeben. Wenn die Autorisierungsfunktion einen anderen Wert für Status zurückgibt, wird dieser Status-Wert von der Remoteverwaltungsfunktion an den Client zurückgegeben.

Rückgabewert

Gibt TRUE zurück, wenn dem aufrufenden Client zugriff auf die angeforderte Verwaltungsfunktion gewährt wird. Wenn die Autorisierungsfunktion FALSE zurückgibt, kann die Verwaltungsfunktion nicht ausgeführt werden. In diesem Fall gibt die Funktion einen Status-Wert an den Client zurück:

Hinweise

Wenn ein Client eine der Remoteverwaltungsfunktionen des Servers anfordert, ruft die Serverlaufzeitbibliothek die Autorisierungsfunktion mit ClientBinding und RequestedMgmtOperation auf. Die Autorisierungsfunktion verwendet diese Parameter, um zu bestimmen, ob der aufrufende Client die angeforderte Verwaltungsfunktion ausführen kann.

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

Weitere Informationen

Autorisierungsfunktionen

RpcMgmtSetAuthorizationFn

Share via