共用方式為

RpcMgmtInqServerPrincNameA 函式 （rpcdce.h）

  • 發行項

RpcMgmtInqServerPrincName 函式會傳回伺服器的主體名稱。

語法

RPC_STATUS RpcMgmtInqServerPrincNameA(
  RPC_BINDING_HANDLE Binding,
  unsigned long      AuthnSvc,
  RPC_CSTR           *ServerPrincName
);

參數

Binding

若要接收伺服器的主體名稱，請指定該伺服器的伺服器系結句柄。 若要接收您自己的 （local） 應用程式主體名稱，請指定 null 值。

AuthnSvc

傳回主體名稱的驗證服務。 有效值為任何有效安全性提供者的常數。

ServerPrincName

傳回在 AuthnSvc 中為驗證服務註冊的主體名稱，此名稱是由 Binding中所參考的伺服器所參考。 如果已註冊多個名稱，則只會傳回一個名稱。

傳回值

價值 意義
RPC_S_OK
 呼叫成功。
RPC_S_INVALID_BINDING
 系結句柄無效。
RPC_S_WRONG_KIND_OF_BINDING
 這是作業的錯誤系結類型。
 
注意 如需有效錯誤碼的清單，請參閱 RPC 傳回值。
 

言論

應用程式會呼叫 RpcMgmtInqServerPrincName 函式，以取得為指定驗證服務註冊的伺服器主體名稱。

RPC 執行時間連結庫會配置 ServerPrincName中所傳回字串的記憶體。 應用程式負責呼叫 RpcStringFree 函式，以釋放此函式所使用的記憶體。

伺服器必須接聽遠端過程調用，此函式才能成功。 如果伺服器未接聽，函式會失敗。

注意

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

要求

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

另請參閱

RpcStringFree