共用方式為

RpcBindingInqAuthInfoExA 函式 (rpcdce.h)

  • 發行項

RpcBindingInqAuthInfoEx函式會從系結控制碼傳回驗證、授權和安全性服務品質資訊。

語法

RPC_STATUS RpcBindingInqAuthInfoExA(
  RPC_BINDING_HANDLE       Binding,
  RPC_CSTR                 *ServerPrincName,
  unsigned long            *AuthnLevel,
  unsigned long            *AuthnSvc,
  RPC_AUTH_IDENTITY_HANDLE *AuthIdentity,
  unsigned long            *AuthzSvc,
  unsigned long            RpcQosVersion,
  RPC_SECURITY_QOS         *SecurityQOS
);

參數

Binding

傳回驗證和授權資訊的伺服器系結控制碼。

ServerPrincName

傳回指向系 結中所參考之伺服器之預期主體名稱指標的指標。 傳回的名稱及其語法的內容是由使用中的驗證服務所定義。

指定 Null 值以防止 RpcBindingInqAuthInfoEx 傳回 ServerPrincName 參數。 在此情況下，應用程式不會呼叫 RpcStringFree 函式。

AuthnLevel

傳回指標，設定為用於使用 Binding進行遠端程序呼叫的驗證層級。 如需 RPC 支援的驗證層級清單，請參閱 驗證層級常數。 指定 Null 值，以防止函式傳回 AuthnLevel 參數。

在 AuthnLevel參數中傳回的層級可能與呼叫RpcBindingSetAuthInfoEx函式時所指定的層級不同。 當 RPC 執行時間程式庫不支援用戶端指定的驗證層級，並自動升級至下一個較高的驗證層級時，就會發生這種差異。

AuthnSvc

傳回指標設定為使用 Binding進行之遠端程序呼叫所指定的驗證服務。 如需 RPC 支援的驗證服務清單，請參閱 Authentication-Service 常數。

指定 Null 值以防止 RpcBindingInqAuthInfoEx 傳回 AuthnSvc 參數。

AuthIdentity

傳回資料結構控制碼的指標，其中包含針對使用 Binding進行之遠端程序呼叫所指定的用戶端驗證和授權認證。

指定 Null 值以防止 RpcBindingInqAuthInfoEx 傳回 AuthIdentity 參數。

AuthzSvc

傳回對用戶端應用程式所要求之授權服務的指標，這個指標會在 Binding上呼叫遠端過程。 如需 RPC 支援的驗證服務清單，請參閱 Authentication-Service 常數。

指定 Null 值以防止 RpcBindingInqAuthInfoEx 傳回 AuthzSvc 參數。

RpcQosVersion

如果將此函式的延伸模組設為) ，則傳遞目前版本的值 (轉送相容性。 請一律將此參數設定為 RPC_C_SECURITY_QOS_VERSION。

SecurityQOS

傳回定義服務品質設定之 RPC_SECURITY_QOS 結構的指標。

傳回值

值 意義
RPC_S_OK
 呼叫成功。
RPC_S_INVALID_BINDING
 系結控制碼無效。
RPC_S_WRONG_KIND_OF_BINDING
 這是作業的系結錯誤種類。
RPC_BINDING_HAS_NO_AUTH
 系結沒有驗證資訊。
 
注意 如需有效錯誤碼的清單，請參閱 RPC 傳回值。
 

備註

用戶端應用程式會呼叫 RpcBindingInqAuthInfoEx 函式，以檢視與伺服器系結控制碼相關聯的驗證和授權資訊。 此函式可讓您查詢系結控制碼上的安全性服務品質。 否則與 RpcBindingInqAuthInfo相同。

RPC 執行時間程式庫會為傳回的 ServerPrincName 參數配置記憶體。 應用程式負責呼叫傳回引數字串的 RpcStringFree 函式。

注意

rpcdce.h 標頭會根據 UNICODE 預處理器常數的定義，將 RpcBindingInqAuthInfoEx 定義為自動選取此函式的 ANSI 或 Unicode 版本。 混合使用編碼中性別名與非編碼中性的程式碼，可能會導致編譯或執行時間錯誤不符。 如需詳細資訊，請參閱 函式原型的慣例。

需求

   
最低支援的用戶端 Windows 2000 專業版 [傳統型應用程式 |UWP 應用程式]
最低支援的伺服器 Windows 2000 Server [傳統型應用程式 |UWP 應用程式]
目標平台 Windows
標頭 rpcdce.h (包含 Rpc.h)
程式庫 Rpcrt4.lib
Dll Rpcrt4.dll

另請參閱

RPC_SECURITY_QOS

RpcBindingSetAuthInfoEx

RpcStringFree