CreateBindLink 関数 (bindlink.h)

この API を使用すると、管理者は仮想パスとバッキング パスの間にバインド リンクを作成できます。 仮想パスは常にローカルですが、バッキング パスはローカルまたはリモート (ネットワーク共有など) である可能性があります。 リンクの作成を成功させるために、 virtualPath の親が表示されている必要があります。 仮想パスとバッキング パスはどちらも、ファイルまたはディレクトリを表すことができます。 以前のリンクの バッキングパス は、後続のリンクの virtualPath にもできます。 CreateBindLink は、管理者特権を持つユーザーのみが呼び出すことができます。 作成されると、バインド リンクはシステム全体に存在し、 RemoveBindLink を呼び出して削除されるまで、またはシステムがシャットダウンされるまで続きます。

構文

HRESULT CreateBindLink(
  PCWSTR                 virtualPath,
  PCWSTR                 backingPath,
  CREATE_BIND_LINK_FLAGS createBindLinkFlags,
  UINT32                 exceptionCount,
  PCWSTR * const         exceptionPaths
);

パラメーター

virtualPath

バインド リンクの作成に使用する仮想パス。

backingPath

バインド リンクの作成に使用するバッキング パス。

createBindLinkFlags

これらのフラグは、ユーザーのニーズに合わせて既定のバインド リンクの動作を変更できます。 詳細については、「 CREATE_BIND_LINK_FLAGS 」を参照してください。

exceptionCount

exceptionPaths パラメーターで指定された例外の数。

exceptionPaths

バインド リンクから除外する例外パス。 アンカーレス仮想パスには定義上子孫がないため、条件を満たすパスがないため、アンカーレス リンクには例外が適用されないことに注意してください。 アンカーレス リンクに例外を渡そうとすると、API からエラーが返されます。

注釈

バインド リンクの作成の詳細については、「 Bindlink の概要 - バインド リンクの作成」を参照してください。

例

CreateBindLink API と RemoveBindLink API の使用方法の完全な例については、バインド リンクの例に関するページを参照してください。

要件

こちらもご覧ください

RemoveBindLink