RpcNsProfileEltInqNextA 関数 (rpcnsi.h)

  • [アーティクル]

RpcNsProfileEltInqNext 関数は、プロファイルから一度に 1 つの要素を返します。

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

構文

RPC_STATUS RpcNsProfileEltInqNextA(
  RPC_NS_HANDLE InquiryContext,
  RPC_IF_ID     *IfId,
  RPC_CSTR      *MemberName,
  unsigned long *Priority,
  RPC_CSTR      *Annotation
);

パラメーター

InquiryContext

RpcNsProfileEltInqBegin 関数から返される名前サービス ハンドル。

IfId

プロファイル要素のインターフェイス識別へのポインターを返します。

MemberName

プロファイル要素のメンバー名へのポインターへのポインターを返します。返された名前の構文は、RpcNsProfileEltInqBegin 関数の MemberNameSyntax パラメーターによって指定されました。

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

Priority

profile-element 優先度へのポインターを返します。

Annotation

プロファイル要素の注釈文字列へのポインターへのポインターを返します。 profile 要素に注釈文字列がない場合は、文字列 \0 が返されます。

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

戻り値

値 意味
RPC_S_OK
 呼び出しは成功しました。
RPC_S_INCOMPLETE_NAME
 名前が不完全です。
RPC_S_NAME_SERVICE_UNAVAILABLE
 名前サービスを利用できません。
RPC_S_NO_MORE_ELEMENTS
 これ以上の要素はありません。
 
メモ 有効なエラー コードの一覧については、「 RPC 戻り値」を参照してください。
 

注釈

RpcNsProfileEltInqNext 関数は、RpcNsProfileEltInqBegin の ProfileName パラメーターで指定されたプロファイルから 1 つの要素を返します。 RpcNsProfileEltInqBegin の InquiryType の値に関係なく、RpcNsProfileEltInqNext はプロファイル要素のすべてのコンポーネント (インターフェイス ID、メンバー名、優先度、注釈文字列) を返します。

アプリケーションは、 RpcNsProfileEltInqNext 関数を繰り返し呼び出すことによって、選択したすべてのプロファイル エントリを表示できます。 すべての要素が表示されると、この関数はRPC_S_NO_MORE_ELEMENTS状態コードを返します。 返される要素は順序付けされません。

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

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

注意

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

要件

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

こちらもご覧ください

RpcNsProfileEltInqBegin

RpcNsProfileEltInqDone

RpcStringFree