RPC_AUTH_KEY_RETRIEVAL_FN funzione di callback (rpcdce.h)

Articolo
08/25/2023

La funzione RPC_AUTH_KEY_RETRIEVAL_FN è un prototipo per una funzione che specifica l'indirizzo di una routine fornita dall'applicazione server che restituisce chiavi di crittografia.

Sintassi

RPC_AUTH_KEY_RETRIEVAL_FN RpcAuthKeyRetrievalFn;

void RpcAuthKeyRetrievalFn(
  void *Arg,
  RPC_WSTR ServerPrincName,
  unsigned long KeyVer,
  void **Key,
  RPC_STATUS *Status
)
{...}

Parametri

Arg

Puntatore a un argomento definito dall'utente alla funzione di acquisizione della chiave di crittografia fornita dall'utente. La libreria di runtime RPC usa il parametro Arg fornito a RpcServerRegisterAuthInfo.

ServerPrincName

Puntatore al nome dell'entità da usare per il server durante l'autenticazione delle chiamate di routine remota. La libreria di runtime RPC usa il parametro ServerPrincName fornito a RpcServerRegisterAuthInfo.

KeyVer

Valore fornito automaticamente dalla libreria di runtime RPC per il parametro key-version. Quando il valore è zero, la funzione di acquisizione deve restituire la chiave più recente disponibile.

Key

Puntatore a un puntatore alla chiave di autenticazione restituita dalla funzione fornita dall'utente.

Status

Puntatore allo stato restituito dalla funzione di acquisizione quando viene chiamato dalla libreria di runtime RPC per autenticare la richiesta RPC. Se lo stato è diverso da RPC_S_OK, la richiesta ha esito negativo e la libreria di runtime restituisce lo stato di errore all'applicazione client.

Valore restituito

nessuno

Osservazioni

Una funzione di recupero della chiave di autorizzazione specifica l'indirizzo di una routine fornita dall'applicazione server che restituisce le chiavi di crittografia.

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

RpcServerRegisterAuthInfo

Condividi tramite