共用方式為

RpcServerInqDefaultPrincName 函式 (rpcdce.h)

  • 發行項

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

語法

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

參數

AuthnSvc

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

PrincName

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

傳回值

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

備註

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

規格需求

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

另請參閱

RpcBindingSetAuthInfo

RpcServerRegisterAuthInfo