共用方式為

RpcServerInqDefaultPrincNameW 函式 （rpcdce.h）

  • 發行項

RpcServerInqDefaultPrincName 函式會取得指定驗證服務的預設主體名稱。

語法

RPC_STATUS RpcServerInqDefaultPrincNameW(
  unsigned long AuthnSvc,
  RPC_WSTR      *PrincName
);

參數

AuthnSvc

當伺服器收到遠端過程調用的要求時，要使用的驗證服務。

PrincName

成功時，包含指定驗證服務的預設主體名稱，如 AuthnSvc 參數所指定。 使用中的驗證服務會定義名稱和其語法的內容。 此主體名稱必須做為 RpcServerRegisterAuthInfo 函式的 ServerPrincName 參數。 如果函式成功，PrincName 必須使用 rpcStringFree 函式來 釋出。 如果函式失敗，則 PrincName 的內容是未定義的，而且呼叫者沒有義務釋放它。

傳回值

價值 意義
RPC_S_OK
 呼叫成功。
RPC_S_OUT_OF_MEMORY
 記憶體不足，無法完成作業。
 
注意 如需有效錯誤碼的清單，請參閱 RPC 傳回值。
 

言論

此函式是取得要傳遞至 RpcServerRegisterAuthInfo 函式之伺服器主體名稱的建議方式。 雖然不需要使用此函式來撰寫伺服器主體名稱，但跨操作系統版本呼叫函式會更容易且更可攜。

注意

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

要求

要求 價值
最低支援的用戶端 Windows 2000 Professional [僅限傳統型應用程式]
支援的最低伺服器 Windows 2000 Server [僅限傳統型應用程式]
目標平臺 窗戶
標頭 rpcdce.h （包括 Rpc.h）
連結庫 Rpcrt4.lib
DLL Rpcrt4.dll

另請參閱

RpcBindingSetAuthInfo

RpcServerRegisterAuthInfo