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
| 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 (rpc.h einschließen) |