次の方法で共有

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
 名前サービス ハンドルが無効です。
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にメモリを割り当てます。 アプリケーションは、返された各メンバー名 文字列に対して RpcStringFree呼び出 します。 RPC グループのメンバーを表示した後、アプリケーションは RpcNsGroupMbrInqDone 呼び出して、照会コンテキストを解放する必要があります。

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

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

手記

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

必要条件

要件 価値
サポートされる最小クライアント Windows 2000 Professional [デスクトップ アプリのみ]
サポートされる最小サーバー Windows 2000 Server [デスクトップ アプリのみ]
ターゲット プラットフォーム の ウィンドウズ
ヘッダー rpcnsi.h (Rpc.h を含む)
ライブラリ Rpcns4.lib
DLL Rpcns4.dll

関連項目

RpcNsGroupMbrInqBegin

RpcNsGroupMbrInqDone を する

RpcStringFree を する