次の方法で共有

RpcNsProfileEltInqNextW 関数 (rpcnsi.h)

  • [アーティクル]

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

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

構文

RPC_STATUS RpcNsProfileEltInqNextW(
  RPC_NS_HANDLE InquiryContext,
  RPC_IF_ID     *IfId,
  RPC_WSTR      *MemberName,
  unsigned long *Priority,
  RPC_WSTR      *Annotation
);

パラメーター

InquiryContext

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

IfId

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

MemberName

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

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

Priority

プロファイル要素の優先度へのポインターを返します。

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 は、プロファイル要素のすべてのコンポーネント (インターフェイスの識別、メンバー名、優先度、注釈文字列) を返します。

アプリケーションは、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 バージョンを自動的に選択するエイリアスとして定義します。 エンコードに依存しないエイリアスをエンコードに依存しないコードと組み合わせて使用すると、コンパイルエラーやランタイム エラーが発生する不一致が発生する可能性があります。 詳細については、「関数プロトタイプの 規則」を参照してください。

必要条件

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

関連項目

RpcNsProfileEltInqBegin

RpcNsProfileEltInqDone

RpcStringFree を する