RpcNsMgmtEntryDeleteW 関数 (rpcnsi.h)

  • [アーティクル]

RpcNsMgmtEntryDelete 関数は、name service-database エントリを削除します。

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

構文

RPC_STATUS RpcNsMgmtEntryDeleteW(
  unsigned long EntryNameSyntax,
  RPC_WSTR      EntryName
);

パラメーター

EntryNameSyntax

EntryName の構文。

HKEY_LOCAL_MACHINE\Software\Microsoft\Rpc\NameService\DefaultSyntaxレジストリ 値エントリで 指定された構文を使用するには、 の値を指定RPC_C_NS_SYNTAX_DEFAULT。

EntryName

削除するエントリの名前へのポインター。

戻り値

値 意味
RPC_S_OK
 呼び出しは成功しました。
RPC_S_INVALID_NAME_SYNTAX
 名前の構文が無効です。
RPC_S_UNSUPPORTED_NAME_SYNTAX
 名前の構文がサポートされていません。
RPC_S_INCOMPLETE_NAME
 名前が不完全です。
RPC_S_ENTRY_NOT_FOUND
 name-service エントリが見つかりませんでした。
RPC_S_NAME_SERVICE_UNAVAILABLE
 名前サービスを利用できません。
RPC_S_NOT_RPC_ENTRY
 RPC エントリではありません。
 
メモ 有効なエラー コードの一覧については、「 RPC 戻り値」を参照してください。
 

注釈

管理アプリケーションでは、 RpcNsMgmtEntryDelete 関数は、エントリが不要になった場合 (たとえば、サーバーがサービスから完全に削除される場合など) にのみ使用されます。

ネーム サービス データベースは比較的安定するように設計されているため、クライアントまたはサーバー アプリケーションで RpcNsMgmtEntryDelete を頻繁に使用すると、パフォーマンスの問題が発生する可能性があります。 クライアントまたはサーバー アプリケーションでエントリを作成および削除すると、ネーム サービス データベースは同じエントリを繰り返し削除して置き換えます。 これにより、レプリケートされたネーム サービス データベースでパフォーマンスの問題が発生する可能性があります。

注意

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

要件

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

こちらもご覧ください

RpcNsMgmtEntryCreate