RPC_AUTH_KEY_RETRIEVAL_FN Rückruffunktion (rpcdce.h)

Die funktion RPC_AUTH_KEY_RETRIEVAL_FN ist ein Prototyp für eine Funktion, die die Adresse einer von der Serveranwendung bereitgestellten Routine angibt, die Verschlüsselungsschlüssel zurückgibt.

Syntax

RPC_AUTH_KEY_RETRIEVAL_FN RpcAuthKeyRetrievalFn;

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

Parameter

Arg

Zeiger auf ein benutzerdefiniertes Argument auf die vom Benutzer bereitgestellte Verschlüsselungsschlüsselerfassungsfunktion. Die RPC-Laufzeitbibliothek verwendet den Arg-Parameter , der für RpcServerRegisterAuthInfo bereitgestellt wird.

ServerPrincName

Zeiger auf den Prinzipalnamen, der für den Server bei der Authentifizierung von Remoteprozeduraufrufen verwendet werden soll. Die RPC-Laufzeitbibliothek verwendet den Parameter ServerPrincName , der für RpcServerRegisterAuthInfo bereitgestellt wird.

KeyVer

Wert, den die RPC-Laufzeitbibliothek automatisch für den Schlüsselversionsparameter bereitstellt. Wenn der Wert null ist, muss die Erfassungsfunktion den zuletzt verfügbaren Schlüssel zurückgeben.

Key

Zeiger auf einen Zeiger auf den Authentifizierungsschlüssel, der von der vom Benutzer bereitgestellten Funktion zurückgegeben wird.

Status

Zeiger auf die status, die von der Erfassungsfunktion zurückgegeben wird, wenn sie von der RPC-Laufzeitbibliothek aufgerufen wird, um die RPC-Clientanforderung zu authentifizieren. Wenn die status nicht RPC_S_OK ist, schlägt die Anforderung fehl, und die Laufzeitbibliothek gibt den Fehler status an die Clientanwendung zurück.

Rückgabewert

Keine

Bemerkungen

Eine Autorisierungsschlüsselabruffunktion gibt die Adresse einer von der Serveranwendung bereitgestellten Routine an, die Verschlüsselungsschlüssel zurückgibt.

Anforderungen

Weitere Informationen

RpcServerRegisterAuthInfo