RpcNsGroupMbrInqNextA 関数 (rpcnsi.h)

  • [アーティクル]

RpcNsGroupMbrInqNext 関数は、グループから一度に 1 つのエントリ名を返します。

メモ この関数は、Windows Vista 以降のオペレーティング システムではサポートされていません。
 

構文

RPC_STATUS RpcNsGroupMbrInqNextA(
  RPC_NS_HANDLE InquiryContext,
  RPC_CSTR      *MemberName
);

パラメーター

InquiryContext

名前サービス ハンドル。

MemberName

RPC グループ メンバー名へのポインターのアドレスを返します。 返された名前の構文は、RpcNsGroupMbrInqBegin 関数の MemberNameSyntax パラメーターによって指定されました。

RpcNsGroupMbrInqNext が MemberName パラメーターを返さないようにするには、null 値を指定します。 この場合、アプリケーションは RpcStringFree 関数を呼び出しません。

戻り値

値 説明
RPC_S_OK
 呼び出しは成功しました。
RPC_S_INVALID_NS_HANDLE
 name-service ハンドルが無効です。
RPC_S_NO_MORE_MEMBERS
 これ以上のメンバーはありません。
RPC_S_NAME_SERVICE_UNAVAILABLE
 名前サービスを利用できません。
 
メモ 有効なエラー コードの一覧については、「 RPC 戻り値」を参照してください。
 

解説

RpcNsGroupMbrInqNext 関数は、RpcNsGroupMbrInqBegin の GroupName パラメーターで指定された RPC グループの 1 つのメンバーを返します。 アプリケーションは、 RpcNsGroupMbrInqNext を繰り返し呼び出すことによって、RPC グループ セットのすべてのメンバーを表示できます。 すべてのグループ メンバーが表示されると、この関数はRPC_S_NO_MORE_MEMBERS状態コードを返します。 返されるグループ メンバーは順序付けされません。

メンバー名を返す RpcNsGroupMbrInqNext の各呼び出しで、RPC ランタイム ライブラリは、返される MemberName にメモリを割り当てます。 アプリケーションは、返される MemberName 文字列ごとに RpcStringFree を呼び出す役割を担います。 RPC グループのメンバーを表示した後、アプリケーションは RpcNsGroupMbrInqDone を呼び出して照会コンテキストを解放する必要があります。

グループ メンバーが返される順序は、グループの表示ごとに異なる場合があります。 つまり、グループ メンバーがアプリケーションに返される順序は、アプリケーションを実行するたびに異なる場合があります。

メモ Windows 2000 Active Directory では、この機能がサポートされています。 以前のバージョンの Windows NT では、Cell Directory Service (CDS) でのみこの関数の使用がサポートされています。
 

注意

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

要件

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

関連項目

RpcNsGroupMbrInqBegin

RpcNsGroupMbrInqDone

RpcStringFree