RPC_AUTH_KEY_RETRIEVAL_FN回呼函式 (rpcdce.h)
RPC_AUTH_KEY_RETRIEVAL_FN函式是函式的原型,可指定傳回加密密鑰之伺服器應用程式提供例程的位址。
語法
RPC_AUTH_KEY_RETRIEVAL_FN RpcAuthKeyRetrievalFn;
void RpcAuthKeyRetrievalFn(
void *Arg,
RPC_WSTR ServerPrincName,
unsigned long KeyVer,
void **Key,
RPC_STATUS *Status
)
{...}
參數
Arg
使用者定義自變數的指標,指向使用者提供的加密密鑰擷取函式。 RPC 運行時間連結庫會使用提供給 RpcServerRegisterAuthInfo 的 Arg 參數。
ServerPrincName
驗證遠端過程調用時,要用於伺服器的主體名稱指標。 RPC 運行時間連結庫會使用提供給 RpcServerRegisterAuthInfo 的 ServerPrincName 參數。
KeyVer
RPC 執行時間連結庫自動為金鑰版本參數提供的值。 當值為零時,擷取函式必須傳回最新的可用索引鍵。
Key
使用者提供函式所傳回之驗證金鑰指標的指標。
Status
當 RPC 執行時間連結庫呼叫擷取函式以驗證用戶端 RPC 要求時所傳回的狀態指標。 如果狀態不是RPC_S_OK,要求會失敗,而運行時間連結庫會將錯誤狀態傳回給用戶端應用程式。
傳回值
無
備註
授權金鑰擷取函式會指定伺服器應用程式提供的例程傳回加密金鑰的位址。
規格需求
需求 | 值 |
---|---|
最低支援的用戶端 | Windows 2000 Professional [僅限傳統型應用程式] |
最低支援的伺服器 | Windows 2000 Server [僅限桌面應用程式] |
目標平台 | Windows |
標頭 | rpcdce.h (包含 Rpc.h) |