RpcNsProfileEltAddA 関数 (rpcnsi.h)
RpcNsProfileEltAdd 関数は、プロファイルに要素を追加します。 必要に応じて、エントリが作成されます。
構文
RPC_STATUS RpcNsProfileEltAddA(
unsigned long ProfileNameSyntax,
RPC_CSTR ProfileName,
RPC_IF_ID *IfId,
unsigned long MemberNameSyntax,
RPC_CSTR MemberName,
unsigned long Priority,
RPC_CSTR Annotation
);
パラメーター
ProfileNameSyntax
ProfileName の構文。
HKEY_LOCAL_MACHINE\Software\Microsoft\Rpc\NameService\DefaultSyntaxレジストリ 値エントリで 指定された構文を使用するには、 の値を指定RPC_C_NS_SYNTAX_DEFAULT。
ProfileName
新しい要素を受け取るプロファイルの名前へのポインター。
IfId
新しいプロファイル要素のインターフェイス識別へのポインター。 既定のプロファイル要素を追加または置換するには、null 値を指定します。
MemberNameSyntax
MemberName の構文。
HKEY_LOCAL_MACHINE\Software\Microsoft\Rpc\NameService\DefaultSyntaxレジストリ 値エントリで 指定された構文を使用するには、 の値を指定RPC_C_NS_SYNTAX_DEFAULT。
MemberName
新しいプロファイル要素に含める名前サービスエントリ名へのポインター。
Priority
インポート操作と参照操作中に新しいプロファイル要素を使用するための相対的な優先順位を示す整数値 (0 から 7)。 値 0 が最も高い優先度です。値 7 が最も低い優先順位です。 既定のプロファイル メンバーを追加する場合は、値 0 を使用します。
Annotation
新しいプロファイル要素の一部として格納されている注釈文字列へのポインター。 注釈文字列がない場合は、null 値または null で終わる文字列を指定します。
この文字列は、情報のみを目的としてアプリケーションによって使用されます。 たとえば、アプリケーションはこの文字列を使用して、IDL ファイルで指定されたインターフェイス名の文字列を格納できます。 RPC は、ルックアップまたはインポート操作中、またはプロファイル要素の列挙に注釈文字列を使用しません。
戻り値
値 | 説明 |
---|---|
|
呼び出しは成功しました。 |
|
名前の構文が無効です。 |
|
名前の構文がサポートされていません。 |
|
名前が不完全です。 |
|
名前サービスを利用できません。 |
解説
RpcNsProfileEltAdd 関数は、ProfileName で指定された name-service エントリの profile 属性に要素を追加します。 ProfileName エントリが存在しない場合、RpcNsProfileEltAdd はプロファイル属性を使用してエントリの作成を試み、IfId、MemberName、Priority、Annotation パラメーターで指定されたプロファイル要素を追加します。 この場合、アプリケーションにはエントリを作成する権限が必要です。 それ以外の場合、必要な特権を持つ管理アプリケーションは、アプリケーションを実行する前に RpcNsMgmtEntryCreate 関数を呼び出してエントリを作成する必要があります。
指定されたメンバー名とインターフェイス ID を持つ要素が既にプロファイル内にある場合、 RpcNsProfileEltAdd は Priority パラメーターと Annotation パラメーターで指定された値を使用して、要素の 優先度 と 注釈 文字列を更新します。
注意
rpcnsi.h ヘッダーは、RPCNsProfileEltAdd をエイリアスとして定義します。これは、UNICODE プリプロセッサ定数の定義に基づいて、この関数の ANSI または Unicode バージョンを自動的に選択します。 encoding-neutral エイリアスの使用を encoding-neutral ではないコードと混在すると、コンパイル エラーまたはランタイム エラーが発生する不一致が発生する可能性があります。 詳細については、「 関数プロトタイプの規則」を参照してください。
要件
サポートされている最小のクライアント | Windows 2000 Professional [デスクトップ アプリのみ] |
サポートされている最小のサーバー | Windows 2000 Server [デスクトップ アプリのみ] |
対象プラットフォーム | Windows |
ヘッダー | rpcnsi.h (Rpc.h を含む) |
Library | Rpcns4.lib |
[DLL] | Rpcns4.dll |