RpcMgmtInqServerPrincName 函式 (rpcdce.h)

  • 發行項

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

語法

RPC_STATUS RpcMgmtInqServerPrincName(
  RPC_BINDING_HANDLE Binding,
  unsigned long      AuthnSvc,
  RPC_WSTR           *ServerPrincName
);

參數

Binding

若要接收伺服器的主體名稱，請指定該伺服器的伺服器系結句柄。 若要接收您自己 (本機) 應用程式的主體名稱，請指定 NULL 的值。

AuthnSvc

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

ServerPrincName

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

傳回值

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

備註

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

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

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

規格需求

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

另請參閱

RpcStringFree