RpcMgmtInqServerPrincName 関数 (rpcdce.h)

RpcMgmtInqServerPrincName 関数は、サーバーのプリンシパル名を返します。

構文

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

Binding

サーバーのプリンシパル名を受け取る場合は、そのサーバーのサーバーバインドハンドルを指定します。独自の (ローカル) アプリケーションのプリンシパル名を受け取る場合は、 値 NULL を指定します。

AuthnSvc

プリンシパル名が返される認証サービス。有効な値は、有効なセキュリティプロバイダーの定数です。

ServerPrincName

[バインド] で参照されているサーバーによって AuthnSvc の認証サービスに登録されているプリンシパル名を返します。複数の名前が登録されている場合は、1 つの名前のみが返されます。

メモ有効なエラーコードの一覧については、「 RPC 戻り値」を参照してください。

アプリケーションは RpcMgmtInqServerPrincName 関数を呼び出して、指定された認証サービスに登録されているサーバーのプリンシパル名を取得します。

RPC ランタイムライブラリは、 ServerPrincName で返される文字列にメモリを割り当てます。アプリケーションは、 RpcStringFree 関数を呼び出して、この関数で使用されるメモリを解放する役割を担います。

この関数を成功させるには、サーバーがリモートプロシージャ呼び出しをリッスンしている必要があります。サーバーがリッスンしていない場合、関数は失敗します。

要件	値
サポートされている最小のクライアント	Windows 2000 Professional [デスクトップアプリ \|UWP アプリ]
サポートされている最小のサーバー	Windows 2000 Server [デスクトップアプリ \|UWP アプリ]
対象プラットフォーム	Windows
ヘッダー	rpcdce.h (Rpc.h を含む)
Library	Rpcrt4.lib
[DLL]	Rpcrt4.dll