RpcMgmtInqServerPrincNameA 関数 (rpcdce.h)

  • [アーティクル]

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

構文

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

パラメーター

Binding

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

AuthnSvc

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

ServerPrincName

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

戻り値

値 意味
RPC_S_OK
 呼び出しは成功しました。
RPC_S_INVALID_BINDING
 バインド ハンドルが無効でした。
RPC_S_WRONG_KIND_OF_BINDING
 これは、操作の間違った種類のバインドでした。
 
メモ 有効なエラー コードの一覧については、「 RPC 戻り値」を参照してください。
 

注釈

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

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

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

注意

rpcdce.h ヘッダーは、UNICODE プリプロセッサ定数の定義に基づいて、この関数の ANSI または Unicode バージョンを自動的に選択するエイリアスとして RpcMgmtInqServerPrincName を定義します。 encoding-neutral エイリアスの使用を encoding-neutral ではないコードと混在すると、コンパイル エラーまたはランタイム エラーが発生する不一致が発生する可能性があります。 詳細については、「 関数プロトタイプの規則」を参照してください。

要件

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

こちらもご覧ください

RpcStringFree