RPC_IF_CALLBACK_FN funzione di callback (rpcdce.h)

Articolo
03/01/2024

Il RPC_IF_CALLBACK_FN è un prototipo per una funzione di callback di sicurezza fornita dall'applicazione. Il programma può fornire una funzione di callback per ogni interfaccia che definisce.

Sintassi

RPC_IF_CALLBACK_FN RpcIfCallbackFn;

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

Parametri

InterfaceUuid

[in] Context

Puntatore a un handle di associazione server RPC_IF_ID che rappresenta il client. Nella dichiarazione di funzione, questo deve essere di tipo RPC_IF_HANDLE, ma è un handle di associazione client e può essere eseguito in modo sicuro. La funzione di callback può passare questo handle a RpcImpersonateClient, RpcBindingServerFromClient, RpcGetAuthorizationContextForClient o qualsiasi altra funzione lato server che accetta un handle di associazione client per ottenere informazioni sul client.

Valore restituito

La funzione di callback deve restituire RPC_S_OK se il client è autorizzato a chiamare i metodi in questa interfaccia. Qualsiasi altro codice restituito causerà che il client riceva l'eccezione RPC_S_ACCESS_DENIED.

Nota Per un elenco di codici di errore validi, vedere Valori restituiti RPC.

Commenti

In alcuni casi, il tempo di esecuzione RPC può chiamare la funzione di callback di sicurezza più di una volta per ogni client per interfaccia. Assicurarsi che la funzione di callback possa gestire questa possibilità.

Il callback di sicurezza deve essere dichiarato come RPC_ENTRY.

Requisiti

Requisito	Valore
Client minimo supportato	Windows 2000 Professional [solo app desktop]
Server minimo supportato	Windows 2000 Server [solo app desktop]
Piattaforma di destinazione	Windows
Intestazione	rpcdce.h (include Rpc.h)

Vedi anche

RpcServerRegisterIfEx

Condividi tramite